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'si To all whom it may concern: 

i=i Be it known that, Nathanial X. Freitas, Shane Conneely, Will Meyer, Jonathan Oakes, 

jrj James Venturi, Evan Simeone, and Scott Gross 



have invented certain new and useful improvements in 



METHOD AND APPARATUS FOR THE 
CREA TION OF SOFTWARE APPLICA TIONS 



of which the following is a full, clear and exact description: 
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The following application claims priority from U.S. Provisional Patent 
Application Serial No. 60/268,872, filed February 16, 200 ^.incorporated herein by 



A computer program listing appendix having the following files: 
com.thinairapps.tag.wml; com.thinairapps.tag; com.thinairapps.tag.html; 
com.thinairapps.tag.hdml; WAPDevice.java; WAPDeviceProfile.java; 
UPWAPDeviceProfile.java; UP WAPDevice.java; TellMeDeviceProfile.java; 
TellMeDevicejava; PocketlEDevicePro file Java; PocketlEDevice.java; 
PalmVIIDeviceProfile.java; PalmVIIDevice.java; OmniSkyDeviceProfile.java; 
OmniSkyDevice.java; NokiaWAPDeviceProfile.java; NokiaWAPDevice.java; 
HTMLDeviceProfile.java; HTMLDevice.java; HDMLDeviceProfile.java; 
HDMLDevice.java; GoWebRIMDeviceProfile.java; GoWebRIMDevicejava; 
GowebPalmDeviceProfile.j ava; Go WebPalmDevice j ava; Ericsson WAPDevicej ava; 
AvantGoDevicePro file Java; AvantGoDevice.java; Getting Started the Hello World 
Sample Connector; DeviceDetective a.k.a. Inspector Gadget Sample Connector; 
Database Connector Sample Connector; Wireless Forms Sample Connector; Tic Tac 
Toe Sample Connector; Webscraper Sample Application; ThinAir Distributed File 
Store Provider Microspft Windows NT/2000 Distribution, Version 1.1; TextFile 
Sample Groupware Provider; Send Email Sample Groupware Connector; Getltems 
Sample Groupware Connector; Customltem Sample Groupware Connector; WML 
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Rendering Sample Connector; Profile Management Sample Connector; Session 
Management Sample Connector; Logging Connector Sample Connector; HTML 
Rendering Sample Connector; PortalConnector.java; and CRMConnectorjava; 
accompanies this application, the disclosure of which is incorporated herein by 
reference. This appendix contains material which is subject to copyright protection. 
The copyright owner has no objection to the reproduction by anyone of the patent 
document or the patent disclosure as it appears in the Patent and Trademark Office 
patent file or records, but otherwise reserves all copyright rights. The following 
notice applies to the software and data as described below and in the drawings hereto: 
Copyright 2001 ThinAirApps, Incorporated, All rights reserved. 



The present invention relates to a method and apparatus for the creation of 
software applications. More particularly, the present invention relates to a software 
development tool kit used to facilitate access to tools and services for developing 
applications on a server. The present invention further relates to a method and 
apparatus for the creation of software applications that enable the interaction between 
a mobile wireless device with functions and information stored in a remote networked 
server. 



The deployment and usage of wireless devices, including both mobile phones 
and personal digital assistants ("PDAs"), is growing at a 66% CAGR domestically 
and 80% globally. By 2005, it is estimated that over one billion wireless devices will 
be in use worldwide. PDAs and mobile phones are increasingly converging with 



> 



FIELD OF THE INVENTION 



BACKGROUND OF THE INVENTION 
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PDAs becoming wirelessly enabled and mobile phones providing smart functionality 
such as personal information management. This new class of smart hand-held devices 
is estimated by IDC to grow to a $19 billion global market by 2004 with shipments of 
over 45 million devices in that year. 



may find that settling on a single device is impossible because of the diverse needs of 
their users. Technically, there are several key factors that may affect which device is 
best suited for the intended application, and thereby influence your design approach: 
Screen size and resolution: Ensuring there is enough screen real estate to 

10 present a reasonable user interface. 

Markup language richness: Some devices support a variant of HTML, with an 
application "shell" and certain resources, such as icons, resident on the device (e.g. a 
PQA on a Palm OS™ device). Other devices use multiple card-based markup 
languages, allowing for device-side manipulation of data through variables and 

15 scripting. 

Input mechanism : If an application will require extended text input, be sure 
that the device provides a keyboard, stylus, or other mechanism that is comfortable to 
a user. If there is a need to support phones that have no such mechanism, it must be 
determined how much data entry can be accomplished by letting a user choose from a 



Native application capability : Some wireless devices support only markup- 
language (browser-type) applications, while others are fully programmable. If an 
application will require complex processing on the device itself, make sure it is of the 
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Wireless devices vary widely in price, capabilities, and coverage. Developers 
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programmable type. (In many cases, though, processing should be offloaded to the 
server; the wireless application should be kept as simple as possible.) 

In developing software for these emerging and growing wireless devices, 
tradeoffs will need to be made. For example: 



device to secure data through screen passwords and data encryption? Or, will real- 
time authentication against a server or directory be possible? If point-to-point device 
communication is involved how will access to application data be granted? 

Latency : Does the combination of device and wireless network provide for an 



i 3 10 experience that is quick and responsive, or that is perceived as slow, forcing the user 



to wait for a response? Can network transactions be fast enough that latency is not an 
issue? 

Delivery : Will the delivery of data to a user be initiated by a server, or by the 
user, or by the device? Is instant notification and alerting important to the user and 



15 application, or potentially annoying and intrusive? What model does the target device 



Connectivity : What is the likelihood of sufficient wireless network coverage 
within the primary geographic location of a user? Does the device or application 
require a user to have an active network connection? Does point-to-point connectivity 
20 between devices play a factor? 

Accessibility : Is the nature of the application such that regular 
synchronization of state between a desktop or server is sufficient, or does the 
application model include the need for complex transactions involving a data scope 
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Security : Will the solution provide a security model that relies upon the client 



and network hardware support? 
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larger than what would be "synched" onto a device? Is synchronization not necessary 
because the quality of connectivity and minimal latency? 

It can be viewed that these tradeoffs are bands in a spectrum much like the 
wireless network frequency spectrum. 

As depicted in FIG. 1, the bands of the spectrum represent different variables 
10 to consider when building a wireless or mobile application. For every application, 
a horizontal slider 12 is moved through the band to choose where a particular 
application falls in the spectrum. Each application requires a different combination of 
variables. 

For example, there are three models or mechanisms that wireless applications 
currently employ to transport data to a wireless device: Pull, Page (or Notification), 
and Push. The goal of pull-based methods is to provide the most up-to-date 
information and data. It is also useful for searching and retrieving web pages, 
documents, media assets, etc. The pull approach may also be used to query and 
retrieve data off of other client devices, which have the request pushed to them. 
Paging is important in point-to-point communication. This is essentially short or 
instant messaging between client devices in order to relay a small bit of timely 
information. Presence and Location play a key part in this type of usage model. A 
Push mechanism should be used as a means of transparent synchronization of certain 
data within background processes of client device software. This may be status 
information, message headers, new client software, or any data needed in an offline, 
disconnected context. 
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There are many other variables that could be put into play such as network 
bandwidth, device operating system, processor capability, battery power, geographic 
mobility, and network usage costs. The criteria identified above are a core subset 
essential to wireless application design. It would therefore be desirable if a method 
5 and apparatus for developing wireless application software were available which 
would make the design of such software more efficient. 



SUMMARY OF THE INVENTION 
10 The foregoing desires have been satisfied to a great extent through use of the 

wireless software development kit ("SDK") of the present invention. The wireless 
software development kit of the present invention gives access to tools and services 
for the purpose of developing applications on the ThinAir Server™ and other 
Application Server products. The SDK expands the possibilities for wireless 
15 communication and allows the support of multiple devices and protocols. Java® 

developers can use the toolkit to create wireless applications for enterprise data stores 
and systems using modular plug-ins customized to existing operating systems and 
applications. Using the SDK there is no need to learn a new device language or 
wireless protocol. 

20 There has thus been outlined, rather broadly, the more important features of 

the invention in order that the detailed description thereof that follows may be better 
understood, and in order that the present contribution to the art may be better 
appreciated. There are, of course, additional features of the invention that will be 
described below and which will form the subject matter of the claims appended 
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hereto. 

In this respect, before explaining at least one embodiment of the invention in 
detail, it is to be understood that the invention is not limited in its application to the 
details of construction and to the arrangements of the components set forth in the 
following description or illustrated in the drawings. The invention is capable of other 
embodiments and of being practiced and carried out in various ways. Also, it is to be 
understood that the phraseology and terminology employed herein, as well as the 
abstract, are for the purpose of description and should not be regarded as limiting. 

As such, those skilled in the art will appreciate that the conception upon which 
this disclosure is based may readily be utilized as a basis for the designing of other 
structures, methods and systems for carrying out the several purposes of the present 
invention. It is important, therefore, that the claims be regarded as including such 
equivalent constructions insofar as they do not depart from the spirit and scope of the 
present invention. 



BRIEF DESCRIPTION OF THE DRAWINGS 
FIG. 1 is a representation of a wireless application "spectrum". 
FIG. 2 is a block diagram representation of the basic request flow showing 

devices that can be linked using the software development kit of the present invention. 
FIG. 3 is a flowchart representing the intra-application routing process of the 

present invention. 

FIG. 4 is a diagram representing an overview of wireless application solutions 
for mobile business use of the present invention. 
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FIG. 5 is a block diagram of the application of a model view controller 
paradigm of a preferred embodiment of the present invention. 

FIG. 6 is a block diagram representing an overview of the wireless 
applications built, using the software development kit, and deployed on a server 
5 platform of a preferred embodiment of the present invention. 



DETAILED DESCRIPTION OF PREFERRED 
EMBODIMENTS OF THE INVENTION 

Referring now to the figures wherein like reference numerals indicate like 

10 elements, in FIG. 2 there is shown a block diagram of the basic request flow between 

wireless devices 14, wireless applications 16 on top of application servers 18, and 

networked information servers 20. 

In an exemplary embodiment, the server of U.S. Patent Application Serial No. 

09/759,204 (the "ThinAir Server™"), the disclosure of which is incorporated herein 

15 by reference, can be used as the application server 18. This application server is an 

open, extensible platform for developing and delivering applications to a variety of 

wireless devices, from Palm OS® devices to WAP-enabled handsets. Implemented in 

100% Pure Java, the ThinAir Server™ architecture manages the communication 

details of each device automatically, allowing developers to concentrate on writing the 

20 business logic of their applications. 

An application for the ThinAir Server™ is composed of one or more 

components called Connectors. Each Connector is a Java program written on top of 

the ThinAir Platform™ API that implements the application for a set of device types. 

The server provides each Connector with several run-time services, including device 
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identification, session management, and a persistent data store for user profile 
information, that satisfy requirements common to most applications. 

For more complex applications, a Connector can be complemented with a 
data-acquisition component called a Provider. By implementing a Provider, 
developers can delegate the interaction with a remote data store to a separate module, 
allowing the Connectors to focus exclusively on communication with devices. The 
ThinAir Server™ supports Providers running within the same process, as separate 
processes on a single machine, or as fully distributed components on multiple servers 
within a public network. These options allow an organization to configure its 
applications for optimal scalability and fault-tolerance. 

Groupware Access for ThinAir Server™ is an example of a fullr featured 
application leveraging the capabilities of the ThinAir Server™. The Groupware 
application is composed of Connectors for Palm™ Connected Organizers, WAP- 
enabled phones, and HTML web browsers, including Pocket PC™. The standard 
ThinAir Server™ installation includes Providers for POP, IMAP, Microsoft 
Exchange™, and Lotus Domino® Groupware servers. Each Connector can 
communicate with any of these Providers to obtain Groupware data. 

Finally, the ThinAir Server™ architecture employs full SSL services 
(including HTTPS) to protect communication between devices, Connectors, and 
Providers. This and other features, including a fully encrypted user profile store, 
ensure that ThinAir Server™ meets the highest industry standards for security within 
a distributed system. 

Because the ThinAir Server™ platform is 100% Java® an application can be 
deployed just about anywhere. The server's architecture enables you to distribute 
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components across multiple machines, allowing for load balancing, creating 

redundancy, and coexistence with complex network and firewall configurations. In 

addition, the ThinAir Server™ supports 128-bit RSA™ SSL encryption. 

Tag Libraries handle the rendering intricacies of common device markup languages 

5 by employing an object-oriented approach to displaying content, messages, and forms. 

Through the Groupware Providers applications can be easily built that access 

Microsoft Exchange Server® or Lotus Domino Server. Providers can also be built 

that leverage the distributed, secure framework of ThinAir Server™ to enable access 

to remote data. 

10 The types of application that can be built on the ThinAir Server™ Platform 

using the SDK include order placement, inventory tracking, customer information, 
messaging, and mCommerce. View and manipulate data stored in ODBC and JDBC 
enabled databases, XML document, and Microsoft Outlook and Lotus Notes forms. 
Components and technologies supported include JavaBeans™ and Servlets, to JINI 
O 15 and XML. 

The ThinAir Server™ Platform includes profiles for most popular wireless 
devices, allowing an application to decide which types of devices it will support, and 
informing that application of the specific device parameters accessing each request. 
WML 1.1, HDML 3.0, and Palm VII HTML are supported for easily delivering data 
20 to target devices. 

In FIG. 3 there is shown a flowchart of the intra-application routing process 
with the steps of device profiling 22 and business logic 24 which can branch off to 
either a device A Renderer 26 or a device B Renderer 28. This demonstrates that the 
basic principal that business logic is unified while the presentation of that logic, and 

10 
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its resulting data, can be communicated through multiple channels. This improves the 
capability of the developer to leverage their existing software infrastructure. 

Referring to FIG. 4, in operation, wireless devices will be useful in many 
different applications for providing access to widely varying data. For example, a 
sales person 30 may utilize a PDA, Blackberry pager or other wireless device 32 to 
access sales information by communicating over a wireless network 34 to a wireless 
application server 36 that is in turn connected to a networked server containing the 
sales information. The basic principal then is that for the Application Class 
(Groupware, Sales Force, Enterprise Resource Management, etc) define a lightweight 
and universal "mobile" definition of the data types and functions which works best for 
the wireless solution, yet can still interact with a variety of network information stores 
and enterprise applications. The communication between the wireless software 
application's server-side components and the legacy application or data is performed 
using standard, well-known protocols and technology. The communication between 
the server components and the wireless software application's device-side components 
must use new, more efficient protocols and technology. The methods and functions of 
this invention improve the capability to develop those new protocols and technology. 

In FIG. 5 there is shown one means to understand the present invention for 
wireless application development in terms of the traditional Model/View/Controller 
paradigm. In object-oriented programming development, model-view-controller 
(MV C) is the name of a methodology or design pattern for successfully and efficiently 
relating the user interface to underlying data models. The MVC pattern is widely used 
in program development with programming languages such as Java, Smalltalk, C, and 



C++. 
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The MVC pattern has been heralded by many developers as a useful pattern 
for the reuse of object code and a pattern that allows them to significantly reduce the 
time it takes to develop applications with user interfaces. The model-view-controller 
pattern proposes three main components or objects to be used in software 
development: 

A Model, which represents the underlying, logical structure of data in a 
software application and the high-level class associated with it. This object model 
does not contain any information about the user interface. 

A View, which is a collection of classes representing the elements in the user 
interface (all of the things the user can see and respond to on the screen, such as 
buttons, display boxes, and so forth). 

A Controller, which represents the classes connecting the model and the view, 
and is used to communicate between classes in the model and view. 



The best example of the inventions usage of Model 40 is with the ThinAir™ 
Groupware API definition. The process of creating it entails an analysis of all 
commercial product's Groupware DataStore Schema and deciding the proper subset 
that would 1) capture the capabilities of all the different products in the market the 
user planned to interface with 2) be lightweight enough to communicate state over a 
low-bandwidth, high-latency wireless network and 3) satisfy the end-user in both 
simplicity and functionality. 



Model 40 
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View 42 

Wireless applications come in one of two flavors. Either a "Smart Client" 
binary that executes on the wireless device, and that is written in C, C++, J2ME, or 
Visual Basic, and built on top of client-side Application Libraries, or a browser- 
targeted application, built using server-side APIs and Tag Libraries, 42. 

Controller 44 

The ThinAir™ Connector handles the interpretation of incoming requests and 
transformation of the Model 40 into an acceptable format. Connectors are server-side 
components which manage logic and flow, and the client-side Network Application 
Libraries perform this functionality. For example, the ThinAir™ Groupware Library 
and associated API (TAGroupware) define both the flow and schema for interacting 
with a remote groupware data store, such as Microsoft Exchange™ or Lotus 
Domino®. 

In FIG. 6 there is shown applications built using the software development kit 
being deployed on the networked server platform. Applications 48 include groupware 
access, device and solution specific applications 50, application libraries 52, network . 
and security libraries 54 and a device or service provider specific networking layer 56. 
The server platform includes wireless networks 58, wireless middleware or gateways 
60, wired networks 62, directory/authentication server 56, database server 58 and 
groupware or email server 60, and a server 52. The networked server platform 70 is 
end-to-end encrypted. The server includes a ThinAir™ server 64, wireless 
middleware server 68, a J2EE application server 66, and a Java® servlet engine. 

The two most important features of the device library are the ability to detect 
what type of device is making a request, and then to query a device object to 
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determine specific characteristics of the requesting device. Therefore, in writing 
Device objects, the first step is to decide, based upon the information provided to the 
ThinAir Server™ in the HTTP request headers, how to identify a specific device type. 
Typically, checking the User- Agent or Accept header of the request for specific 
strings can do this. For example, the HTMLDeviceProfile checks for the presence of 
the string "Mozilla" in the User-Agent header, as well as the string "text/html" in the 
Accept header. If either of these strings are present, the requesting device is of type 
HTML. Care must be taken to ensure that whatever means used to identify a device 
type will be sufficient for all possible requests of the device type, but will not accept 
any device of any other type. 

Once a means of identifying the device type based upon the HTTP request has 
been confirmed, the next step is to decide what properties to encapsulate into the 
Device object representing the new device. For example, the screen size of the 
device, or what languages the device supports may be included. 

There are two primary ways to decide what properties to include: by 
inspecting the headers included with the HTTP request, or by examining any device 
documentation supplied by the device manufacturer for specific device models. When 
a request is received, there are typically a number of HTTP headers that specify 
certain device specific parameters. For example, when an HTML browser makes a 
request, it sends along the headers ACCEPT-LANGUAGE, ACCEPT-ENCODING, 
HOST, and CONNECTION, which all contain information specific to the machine 
where the browser is running. When an HTMLDevice is created, there are four device 
properties corresponding to these headers, which are initialized to the values in the 
HTTP headers. 
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If the user desires to include information that cannot be found in the request 
headers, the user may do so by detecting the specific device model making a request, 
and then initializing device properties using information found in device 
documentation. This method may provide a more complete expression of a device, 
5 but may be more difficult due to the necessity of detecting a device's model number, 
as well as posing a larger risk of Device objects containing outdated information. 

An example of programming for determining the type of device making an 
HTTP request is provided below: 

public boolean isRequestFromDevice ( ServletRequest req) 

10 { 

if ( super . isRequestFromDevice (req)) 
{ 

HttpServletRequest request = (HttpServletRequest ) req; 
15 String accept = request . getHeader ( "Accept " ) ; 

String userAgent = request . getHeader ( "User-Agent" ) ; 

return { ((userAgent != null) && (userAgent . indexOf ( "Mozilla" ) >= 0)) I I 
((accept != null ) && (accept . indexOf ( "text /html" ) >= 0)) ); 

20 } 

return false; 

} 

25 Wireless Forms Application 

The goal of this application is to provide an example of an application that 
interacts with a JDBC-accessible relational database. Forms and Views are displayed 
in both HTML and WML, allowing the user to update and query data in a remote 
database from their wireless device. Wireless Forms Applications are defined in a 

30 simple XML document which conforms to the following framework (there is no DTD 
defined): 

The following is an example Application definition: 



<application name="User Manager"> 
35 <database> 



15 



Attorney Ref No. 12(^ ^00 PATENT 

<dsn>jdbc : odbc: sample__app</dsn> 
<login>userl</login> 
<password>password</password> 
</database> 
5 <views> 

<view name= ,, Users"> 

<query>SELECT login AS Users, password AS Pwd FROM users</query> 
</view> 
</views> 
10 <forms> 

<form name="New User"> 

<query>insert into users (login, password) select 'Sign', ' $pwd ' </query> 

<mappings> 

<display> 

15 <input>UserName< /input > 

<field>lgn</field> 
<type>text</type> 

</display> 
<display> 

20 <input>Password</input> 

<field>pwd</field> 
<type>password</type> 

</display> 
</mappings> 
25 </f orm> 

</f orms> 
</application> 

Below is the code for the "handle" method of the Wireless Forms connector. 
30 It demonstrates the use of the Device object as a means of creating specific Renderers 
to handle the specific rendering for that device class. This application allows for 
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rendering to occur either in the Wireless Markup Language or Hypertext Markup 
Language formats. 



public void handle (Properties req, Device device, Output St ream out) 
{ 



//extract current action using defined variable name constant 
String action = req . getProperty ( ACTION_ARG) ; 

10 //init object used to store output from renderering 

String output = null; 



//init the renderer superclass 
ApplicationRenderer renderer = null; 



15 



//based on the device type, determine which subclass of 
//ApplicationRenderer to use. Since some WAP devices also 
//supports HTML, we will specifically look for WAP suport first 
if (device instanceof WAPDevice) 

20 < 

//its a WAP device, so create a WML Renderer 
renderer = new WMLApplicationRenderer (); 

} 

else if (device instanceof HTMLDevice) 

25 { 

//its a HTML deice, so create an HTML Renderer 
renderer = new HTMLApplicationRenderer (); 

> 

30 //if the action is NULL or is the default APP_ACTION 

//get the list of available applications 
if (action == null || action . equals (APP_ACTION) ) 
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output = wf . getApplications (renderer) ; 



//the action tells the server to reload application definitions 
else if (action. equals (RELOAD_ACTION) ) 
{ 

try 
{ 

wf . init ( APP_DIR, DB_DRIVER) ; 

output = wf . getApplications (renderer) ; 

} 

catch (Exception e) 
{ 

System. err . println ( "WirelessFormsConnector . handle : 
error on WirelessForms init: " + e) ; 

} 

} 



//retrieve and render a Menu, which display Forms and Views, for a specific 
Application 

else if ( action. equals (MENU_ACTTON) ) 

output = wf .getMenu ( req . getProperty (APP_ARG) , renderer); 



//retrieve and render a View (essentially a JDBC ResultSet) 
else if (action. equals (VI EW_ACT ION) ) 
output = 

wf . getView ( req . getProperty ( APP_ARG) , req . getProperty ( ITEM_ID) , req . getProperty ( KEY ) 
erer) ; 



// 

else if (action . equals (FORM^ACT ION) ) 
output = 

wf.getForm (req. getProperty (APP__ARG) , req . getProperty ( ITEM_ID) , renderer) ; 



//insert data into a table, and display a confirmation 
else if (action. equals (INSERT_ACTION) ) 

{ 
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output = wf . insertEntry 
(req. getProperty (APP_ARG) , req . getProperty ( ITEM__ID) , req, renderer) ; 



) 



//write the output to the OutputStream via a PrintWriter 
PrintWriter ps = new PrintWriter (out) ; 
ps -println (output) ; 
ps . flush ( ) ; 
ps . close { ) ; 



This method "renderForm ()" from the WMLApplicationRenderer class used 
in the sample above, demonstrates the rendering of the Application and Wform 
objects into specific markup langague viewable on a Wireless Application Protocol 
(WAP)-enabled device. 

public String renderForm (Application app, WForm form) 
{ 

java . util . Properties props = f orm. getDisplayMap ( ) ; 



java .util . Properties urlP = new j ava . util . Properties {) ; 
urlP .put ( "ap" , app . getName ( ) ) ; 
urlP.put ("a", INSERT_ACTION) ; 
urlP .put ( "i" , form. getName ( ) ) ; 

MultiplelnputCard mic = new MultiplelnputCard ( "cl", form. getName ()} ; 



} 



Enumeration keys = props . keys () ; 



String key = null, label = null; 



Labeledlnput [ ] li = new Labeledlnput [props . size ()] ; 



1 1 I 
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int i = 0/ 

while (keys . hasMoreElements ( ) ) 

{ 

5 key = (String) keys . nextElement () ; 

label = (String) props . get (key) + ":"; 
li{i++3 = new Labeledlnput (key, label) ; 
urlP.put (key, "$"+key) ; 

} 

10 

String url = URLBuilder . buildWapUrl ( "?" , urlP, true) ; 

mic.buildCard (url , "Submit" , li, Go .METHOD_GET) ; 
*=J 15 WMLTagDocument deck — new WMLTagDocument ( ) ; 

= " s | deck . addCard (mic) ; 

; return deck . render () ; 

20 

The above description and drawings are only illustrative of preferred 
embodiments which achieve the objects, features, and advantages of the present 
25 invention, and it is not intended that the present invention be limited thereto. Any 
modification of the present invention which comes within the spirit and scope of the 
following claims is considered to be part of the present invention. 



20 



• 



COMPUTER LISTING APPENDIX 



13 

m 
m 

■F 

m 

m 

Q 

m 
p 

m 
m 



C: \TASS\ThinAirServer\ . . \com\thinairapps\tag\wml\WMLTagDocument . java 1 

package com. thinairapps . tag . wml ; 
import com . thinairapps . tag .* ; 
/ *★ 

* This is the main container for all WML documents. It is directly analogous to a WML file * 

containing 

* any number of cards and card elements. 
*/ 

public class WMLTagDocument extends TagDocument 
{ 

public final static String DEFAULT_XML_LANG = "en-us"; 

public final static String XML__HEADER = "<?xml version=\ " 1 . 0\ " ? > " ,- 

public static String DOCJTYPE = "<lDOCTYPE wml PUBLIC \ " -//WAP FORUM //DTD WML 1.1//EN * 
\" \"http:/ /www. wapforum.org/DTD/wml_l . l.xml\">" ; 

Head head; 
Template template ; 
Card card; 

"/**Creates a standard WMLTagDocument (&lt ; wml&gt ; &lt ,- /wml&gt ; ) 
*/ 

ixs. public WMLTagDocument ( ) { 

super ( "wml" , " text/vnd . wap . wml 11 ) ; 

;s ) 

% _s /**Creates a WMLTagDocument with the specified •xml: lang' attribute. In general, 
J? * you should use the no arg constructor. 

ill * ©param xml_lang the specified xml : lang type. 

Q */ 

sJL public WMLTagDocument (String xml_lang) { 

w thisO; 

s getRootO .addAt tribute { "xml : lang" ,xml_lang) ,- 

:1! /**Set's the Head tag for this deck. 

ill ★ 

m */ . 

^ public void setHead(Head head) throws InvalidTagException { 
I s * this, head = head; 

1^ resetChildren { ) ; 

} 

/★★Set's a Template for this deck. 
* 

public void setTemplate (Template template) throws InvalidTagException { 
this . template = template; 
resetChildren ( ) ; 

} 

public void setCard(Card card) throws InvalidTagException { 
this. card = card; 
resetChildren ( ) ;^ 

} 

/★★★Adds a Card to this document. 
* 

iram card A Card to be added to this document. 



*/ 

public void addCard(Card card) { 
try { addChild (card) ; } 
catch (InvalidTagException e) { 
e .printStackTrace ( ) ; 

} 

} 
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/***This clears all of the children for this Card. 
*/ 

private void resetChildren ( ) throws InvalidTagException { 

getRoot ( ) .getChildren ( ) . removeAHElements ( ) ; 

if (head != null) 

addChild(head) ; 

if (template != null) 
addChild( template) ; 

if (card != null) 
addChild(card) ; 

} 

/***This renders the entire WMLTagDocument . 
* 

* ©return String the document rendered to a String. 
*/ 

public String render ( ) { 

StringBuffer output = new StringBuf f er ( ) ; 
output - append (XML_HEADER + "\n"); 
output .append (DOC_TYPE + ! '\n\n n ); 

output . append ( super . render ( ) ) ; 

return output . toString () ; 
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package com . thinairapps . tag . wml ; 
import com. thinairapps . tag .* ; 
import java . util . Enumeration; 
/** 

* The basic WMLTag which all other tag classes in this package subclass 
*/ 

public class WMLTag extends Tag 

{ 

I * * 

* ©param name the tag text to use <"name" > 

* ©param closingTag indicates if this is a standalone tag, or if it has an accompanying 

closing tag 

*/ 

public WMLTag (String name, boolean closingTag) 
{ 

super (name, closingTag) ; 

} 

I * * 

* ©param name the tag text to use < "name 11 > 
*/ 

public WMLTag (String name) 

0 { 

lO super (name) ; 

1 > 

"~§ / * * 

t€ * called by the render () method to render the start tag 

iLi */ 

C % protected String renderOpenTag ( ) { 
^ StringBuffer output = new StringBuf f er ( ) ; 

; //render self open 

j ^% output . append ( " < " ) ; 

output . append (getName ( ) ) ; 

O Enumeration eAttribs = getAttributes (). elements () ,- 

111 while (eAttribs . hasMoreElements ( ) ) 

\^ output . append ( " 11 + ( (Attribute) eAttribs .nextElement ()). render ()) ; 

if (iisClosedTagO ) 

output . append ( " / " ) ; 

output . append ( " > " ) ; 

return output . toString ( ) ; 

} 

} 
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package com . thinairapps . tag . wml ; 

import com. thinairapps . tag . AbstractCharacterEncoder ,- 
/ * * 

* A utility class that reformats characters, such as " , < # 

* >, ',&,$, etc. which are reserved for 

* use by WML /WAP, and that must been encoded in all uses. 
* 

* This class is a singleton so it has a private constructor 
* 

* ©author kleemax 
*/ 

public class WMLCharacterEncoder extends AbstractCharacterEncoder 

/////////////////////////////////////////////////////////// 
// CONSTANTS 

private final static String [] ENCODED_STRINGS = { "&", 

"" " , 





"< 


it 






"&gt ; 








"&apos; " 






»$$«, 








it ti 

# 








it ti 








" (TM) 






•Li 


"&apos; " 


}; 


jy 


private final static char[] CHARS_TO_ENCODE = { 


// 


AMPERSAND 




i tt t 

f 


// 


QUOTE 




'<* , 


// 


LESS THAN 




'>' , 


// 


GREATER THAN 




39, 


// 


the ' apo s t rophy 




'$', 


// 


DOLLARS I GN 




•\n«, 


// 


NEW LINE 




*\r' , 


// 


LINE FEED 




8482, 


// 


TRADEMARK 




180 }; 


// 


FORWARD APOSTROPHY 



\~z // UNUSED 

ifi private final static String SOFT_HYPHEN = "kshy;" ; 

Y~ private final static String NON_B RE AK I NG_S P AC E = " " ; 

hH///// //////////////////////////////////////// /////////// 

// VARIABLES 

private static WMLCharacterEncoder s_Singleton = null; 

/////////////////////////////////////////////////////////// 
// PRIVATE CONSTRUCTOR 

private WMLCharacterEncoder ( ) { 

// Singleton. No constructor 

} 

/////////////////////////////////////////////////////////// 
// ABSTRACT METHODS OVERRIDDEN FROM SUPERCLASS 

/**Allows the subclass to specify the list of characters that should 

* be encoded. Note that this list should have the same number of 

* elements, with each element in the same position, as the array 

* that is returned from getEncodedStrings ( ) . 
* 

* ©return A list of special characters which should be encoded in 

* the current markup language . 
*/ 

protected char [] getCharactersToEncode ( ) { 
return CHARS__TO_ENCODE ; 

} 

/**Allows the subclass to specify the list of strings that should 
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* be used as escape sequences for each character that should be 

* encoded. Note that this list should have the same number of 

* elements, with each element in the same position, as the array 

* that is returned from getCharactersToEncode ( ) . 
* 

* ©return A list of strings which are valid escape sequences in 

* the current markup language - 
*/ 

protected String [] getEncodedStrings ( ) { 
return ENCODED_STRINGS ; 

} 

/////////////////////////////////////////////////////////// 
// METHODS 

public static String clipAndEncode (String inText , int inStart, 

int inLength, String inTail, int[] outLengthUsed) { 
if (s_Singleton == null) { 

s__Singleton = new WMLCharacterEncoder ( ) ; 

} 

return s_Singleton . clipAndEncodeWithTail ( inText , inStart , inLength, inTail, 
outLengthUsed) ; 
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package com. thinairapps . tag .wml ; 

import java . util . Enumeration ,- 
import java. util - Properties ; 

import j ava . net .URLEncoder ; 

/**This is a convenience class for building URLs (href Strings) suitable for use within * 
various markup languages. 

* 

*/ 

public class URLBuilder 

{ 

public static String DELIMETER = "Scamp;"; 
public static String NAME_VALUE_DELIMETER = 

private final static String RND_KEY = "trnd"; 
private final static String DEFAULT_BASE_URL = "?"; 

/**Builds a URL suitable for use within a WML deck. 

iram baseURL the domain name, path, etc. as needed. Everything required before the 



' ? ' 

*@param props a Properties object containing the name value pairs of the HTTP URL * 
m parameters. 

l -*f *@param addRandom indicates if a random parameter should be added in the form, 'trnd 
?0 ="1234" ' . This 

\ti * is used as a means to force browsers not to use cached pages . 
*/ 

~ public static String buildWapUrl (String baseUrl, Properties props, boolean addRandom) 
ut { 

HJ StringBuffer url = new StringBuf f er ( ) ; 

if (baseUrl ! = null) 
{ 

!□ url. append (baseUrl); 

■fj if ( ! baseUrl . endsWith (DEFAULT_BASE_URL) ) 

U url. append (DEFAULT_BASE_URL) ; 

d«* else 

\*j url. append (DEFAULT_BASE_URL) ; 

Enumeration enum = props . keys () ; 
String key = null, value = null; 
while (enum.hasMoreElements ( ) ) 

{ 

key - (String) enum. nextElement () ; 

value = props . getProperty (key) ; 

if ( lvalue, start sWith ( ) ) 

value = URLEncoder . encode (value) ; 

url. append (key); 

url . append ( N AM E_VALUE__D ELIMETER) ; 
url. append (value); 



} 



if (enum . hasMoreElements ( ) ) 
url. append (DELIMETER) ; 



if (addRandom) 
{ 

url. append (DELIMETER); 

url . append ( RND_KEY ) ; 
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url . append (NAME_VALUE_DE LI METER) ; 
url . append (genRnd ( ) ) ; 

} 

return url . toString ( ) ; 

} 

private static String genRnd () 

String rnd = new java . util . Date () .getTime ( ) +""; 

//trim the random number to reduce URL size 
int length = rnd . length <) ; 
if (length >=4) 

rnd = rnd. substring (length-4 , length) ; 
return rnd; 
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package com. thinairapps . tag . wml ; 

/** 

* The &lt ; timer &gt ; element provides a method for invoking a task automatically after some / 
period of user inactivity. Any task or user action that activates the card starts the / 
timer, and executing any task element stops it. You can only associate one task per timer/ 
, and you can only define one timer per card. 

*/ 

public class Timer extends WMLTag 
{ 

/** 

* ©pararn name The name of the variable in which the device stores the timer value. If the/ 

variable has no value when the timer is initialized, the device sets it to the value / 
specified for the default attribute. The device sets this variable to either the / 
current timer value when the user exits the card or 0 if the timer expires. 

* ©param value A string specifying the value for the variable specified by the key / 

attribute. You must specify <timer> values in units of 1/10 seconds- -so, for example / 
, a value of 100 equals 10 seconds. Specifying a value of 0 disables the timer. 

*/ 

public Timer (String name, int value) { 
super ( 11 timer" , false) ; 
addAt tribute ( "name" , name) ,- 
addAttribute ( "value" , value * 10 + ""); 

} 

|jD / * * 

30 * ©param value A string specifying the value for the variable specified by the key / 
If! attribute. You must specify <timer> values in units of 1/10 seconds- -so, for example / 

, a value of 100 equals 10 seconds. Specifying a value of 0 disables the timer. 

"2 */ 

*p public Timer (int value) { 
Id this ("default" , value) ; 

} 

IS 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException; 

/**This is a convenience class for formatting Text in a WMLdeck. 
* 

*/ 

public class TextStyle extends WMLTag 

{ 

public final static String PLAIN = 

public final static String BOLD = "b" ; 

public final static String BIG = "big"; 

public final static String EMPHASIZE = "em" ; 

public final static String ITALIC = "i"; 

public final static String SMALL = "small"; 

public final static String STRONG = "strong"; 

public final static String UNDERLINED = "u"; 

String style = PLAIN; 
/ * * 

*@param style one of the String constants defined in this class. 
*/ 

public TextStyle (String style) { 
^ super ( " " , true) ; 

=— ; this. style = style; 

m > 

^ / * * 

*@param style one of the String constants defined in this class. 
t S *@param child a child tag to be formatted in the given syle . 

ijj */ 

V"z public TextStyle (String style, WMLTag child) throws InvalidTagException { 
^ super ( " " , true) ; 

ixj this, style = style; 

3 addChild (child) ; 

IP protected String renderOpenTag ( ) { 

Q if (style != PLAIN) 

— return "<" + style + 11 >" ; 

•L else 

i=P return " " ; 

protected String renderCloseTag ( ) { 
if (style != PLAIN) 

return "</" + style + ">"; 

else 

return " " ; 

} 
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package com. thinairapps . tag . wml ; 
I * * 

* This is a simple class that allows you to insert an arbitrary String 

* into a WML Deck. 
*/ 

public class Text extends WMLTag 

{ 

/★★★Create a new Text Object with the given String 
*/ 

public Text (String text) { 
super (text , false) ; 

} 

/★★★Get the String you used to define this Text Object. 
*/ 

public String getTextOnly ( ) { 
return getName ( ) ; 

} 

/★★★Return the Sting defined for this Text Object 
*/ 

public String render () { 
return getName ( ) ; 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException; 

/ * * 

* Element that defines deck-level event bindings (i.e. characteristics that apply to all *r 
cards in the deck) 

*/ 

public class Template extends WMLTag 

public Template () { 

super ( " template " ) ; 

} 

/** 

* ©param onEnter Forward specifies the URL to open if the user navigates to a card 

through a <go> task 

* ©param onEnterBackward specifies the URL to open if the user navigates to a card w 

through a <prev> task 

* ©param onTimer specifies the URL to open if the &lt timer&gt ; element expires 

*/ 

public Template (String onEnterForward, String onEnterBackward, String onTimer) { 
this(); 

addAttribute ( "onenterf orward" , onEnterForward) ; 
,„ addAttribute ( "onenterbackward" , onEnterBackward) ; 

O addAttribute ( "ontimer" , onTimer) ,- 

public void addChi Id (WMLTag child) throws InvalidTagException { 
2 if (child instanceof Do | | child instanceof OnEvent) 

5 p super .addChild (child) ; 

llj else 

l r % throw new InvalidTagException ( "Template only supports Do and OnEvent child ^ 

2 tags"); 

m } 
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package com. thinairapps . tag . wml ,- 
/** 

* The basic Task type which is subclassed by other classes ( &lt ;go&gt ; , <do>) 
*/ 

public abstract class Task extends WMLTag 

public Task (String name, boolean closed) 



super (name , closed) ; 




• 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException ; 

/ ** 

* The <tr> element is used as a container to hold a single table row. Table rows may betf 

empty, 

* in other words, all cells are empty. 
*/ 

public class TableRow extends WMLTag 
public TableRow () { 



super ( "tr" ) ; 
} 




■E 
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package com. thinairapps . tag . wml ; 

import com. thinairapps - tag . InvalidTagExcept ion ; 

/** 

* The &lt,*td> element is used as a container to hold a single table cell data within a * 

table row. 

* Table data cells may be empty. The user agent should do a best effort to deal with multiples 

line 

* data cells that may result from using images or line breaks. 
*/ 

public class TableCell extends WMLTag 

{ 

public TableCell () { 
super ( "td" ) ,- 

} 

/♦Constructs a TableCell with the given child tag. 
* / 

public TableCell (WMLTag child) throws InvalidTagExcept ion { 
this () ; 

addChild (child) ; 

} 

_ public void addChild (WMLTag child) throws InvalidTagExcept ion { 

f3 if (child instanceof Text | | child instanceof Image | | child instanceof Anchor) 

tp super .addChild (child) ; 

i-rs else 

throw new InvalidTagExcept ion ( "TableCell only supports Text, Image, and Anchor *r 
^ children tags"); 

•P } 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException ,- 

/** . 

* The &lt ; table&gt ; element allows you to specify columnar format. WML tables are similar to * 

HTML 

* tables but with fewer capabilities. When defining a table, you have to declare the number / 

of columns, 

* followed by some content. The content can include empty rows and columns. 
*/ 

public class Table extends WMLTag 

^ public final static String AL I GN_LE FT = "left"; 

public final static String ALIGN_CENTER = "center"; 
public final static String AL I GN_R I GHT = "right" ; 

public Table () { 

super ("table") ; 

} 

/** 

* ©param title Specifies a label for the table. 

* ©param align ( ALIGN_LEFT , ALIGN_CENTER, AL I GN_R I GHT ) Specifies text alignment relative 
to the column. 

* If you do not specify the align attribute, the text is automatically left-aligned. 
* 

* ©param columns Specifies the number of columns for the row set. Specifying a zero value/ 

for 

'-4 * this attribute is not allowed. 

■E */ 

5-s public Table (String title, String align, int columns) 

1% { 

^ thisO; 

\B addAttribute ( "title" , title) ; 

- addAttribute ( "align" , align) ; 

]^ addAttribute ( "columns" ," " + columns); 

13 public void addChi Id (WMLTag child) throws InvalidTagException { 

I'Z if (child instanceof TableRow) 

■fj super .addChild (child) ; 

!3 else 

1^ throw new InvalidTagException ( "Table only supports TableRow child tags") ; 

} 



o 
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package com. thinairapps . tag . wml ; 

/**The &lt ; spawn&gt ; element defines a spawn task, indicating the creation of a child context 

* and invocation of a URL in that child context. If the URL names a WML card or deck, the * 

card 

* is displayed, and the URL becomes the basis for a new history stack in the child context. 

See 

* specific WML browser documentation for more details. 
* 

*/ 

public class Spawn extends WMLTag 
{ 

public Spawn () 

{ 

super ("spawn", true); 

} 

} 
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package com. thinairapps . tag . wml ,- 

import com. thinairapps . tag . InvalidTagException; 

/ * * 

* A widget for generating a card with a single text- type input. For details on the ^ 

constructors, see the constructors for 

* Card. 
*/ 

public class SinglelnputCard extends Card 
{ 

public SinglelnputCard ( ) { 
super ( ) ; 

} 

public SinglelnputCard (String id) { 
super (id) ; 

} 

public SinglelnputCard (String id, String title) { 
super (id, title) ; 

} 

public SinglelnputCard (String id, String title , boolean newContext) { 
^ super (id, title, newContext ) ; 

!E } 

J'l public SinglelnputCard (String id, String title , boolean newContext , boolean ordered) { 
^ super (id, title, newContext , ordered) ; 

:R } 

i = I * * 

~~ * ©param href the url to which the results of the select input are to be submited 

X M * ©param label the label to use with the input field 

1 * ©param name the name of the input field 

i~z * ©param format the format mask to use with the input field 

■fj public void buildCard (String href , String label, String name, String format) 

2 { 

HI Do dol = new Do (Do . TYPE_ACCEPT, new Go (href , false) ) ; 

p addChild(dol) ; 

Paragraph p = new Paragraph ( ) ; 
p.addChildfnew Text ( label )) ; 
Input input = new Input (name) ,- 
input . set Format ( format ) ; 
p.addChild(input) ; 
addChild(p) ; 

} 

/** 

* Build a Card that uses the POST method 

* ©param href the url to which the results of the select input are to be submited 

* ©param label the label to use with the input field 

* ©param name the name of the input field 

* ©param format the format mask to use with the input field 

* ©param extraFields array of &lt ,-postf ield&gt ; elements 
*/ 

public void buildPostCard (String href, String label, String name, String format, PostField * 
[] extraFields) 

{ 

Go goa = new Go (href , true, Go . METHOD_POST) ; 
goa .addChild(new PostField (name , "$"+name) ) ; 

if (extraFields null) 

{ 
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for (int i = 0; i < extraFields . length ; 
goa . addChild (extraFields [i] ) ,- 

} 

Do dew = new Do ( Do . TYPE_ACCEPT , goa ) ; 
addChild (dew) ; 

Paragraph p = new Paragraph ( ) ; 
p. addChild (new Text ( label )) ; 
Input input = new Input (name) ; 
input . setFormat (format) ; 
p . addChild (input ) ; 
addChild (p) ,- 

} 



} 
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package com . thinairapps . tag . wml ; 
/ * * 

* The &lt ; setvar&gt ; element sets a variable to a specified value when the device executes a * 

&lt ;go&gt ; , 

* &lt ;prev&gt ; , &lt ; spawn&gt ; , or &1 t ; ref resh&gt ; task. 
*/ 

public class SetVar extends WMLTag 

public SetVar (String name, String value) 
{ 

super ( "setvar" , false) ; 
addAttribute ( "name " , name) ; 
addAttribute ( "value" , value) ; 



} 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException; 

/** 

* A widget for generating a card with a Select list input. For details on the constructors, * 

see the constructors for 

* Card. 
*/ 

public class SelectlnputCard extends Card 

{ 

public SelectlnputCard ( ) { 
super ( ) / 

} 

public SelectlnputCard (String id) { 
super (id) ; 

} 

public SelectlnputCard (String id, String title) { 
super { id, title) ; 

} 

,„ public SelectlnputCard (String id, String title , boolean newContext) { 
IrJ super (id, title, newContext) ; 

m ) 



■p } 



public SelectlnputCard (String id, String title , boolean newContext , boolean ordered) { 
super (id, title, newContext , ordered) ; 



i ~s / * * 

'"f * ©param href the url to which the results of the select input are to be submited 

1 33 * Oparam label the text label for this input 

z * ©param name the name of the select tag 

* ©param optionVals name/value pairs for all of the options 

!S * ©param align the text alignment to use for the display (Paragraph . LEFT, etc) 

=D * ©param mode the text wrap mode to use for the display (Paragraph.NO_WRAP) 

Q */ 

m public void buildCard (String href, String label, String name , String [] [] optionVals , String 
;fj align, String mode) throws InvalidTagException { 

|-J= Option[] options = new Option [optionVals . length] ; 

for (int i = 0; i < opt ionVals . length ; i++) { 
options [i] = new Option (optionVals [i] [1] ) ; 
options [i] . setLabel (optionVals [i] [0] ) ; 

} 

buildCard (href , label , name, options , align, mode) ; 



/ * * 

* ©param href the url to which the results of the select input are to be submited 

* ©param label the text label for this input 

* ©param name the name of the select tag 

* ©param options the set of &lt ;opt ion&gt ,- tags to use for this select 

* ©param align the text alignment to use for the display ( Paragraph . LEFT , etc) 

* ©param mode the text wrap mode to use for the display (Paragraph .NO_WRAP) 
*/ 

public void buildCard ( String href, String label, String name , Option [ ] options , String align, ^ 
String mode) throws InvalidTagException { 

Do dol = new Do (Do . TYPE_ACCEPT, new Go (href , f al se ) ) ; 
addChild(dol) ; 

Paragraph pHeader = new Paragraph (align, Pa rag raph . MODE_WRAP ) ,- 
pHeader . addChild (new Text(label)) ; 
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addChild(pHeader) ; 

Paragraph p = new Paragraph (align, mode) ; 

Select select = new Select ( " " , name , false) ; 
Option cOpt = null; 

for (int i = 0; i < opt ions . length; i++) 
select . addOption (options [i] ) ; 

p. addChild( select) ; 
addChild(p) ; 

} 
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package com . thinairapps . tag . wml ; 

import com. thinairapps . tag . Inval idTag Except ion; 

/ ** 

* The &lt ; select&gt ,- tag element specifies a list of options from which the user can choose. * 

You can 

* specify either single- or multiple-choice &lt ,- select&gt ; tag elements. 
*/ 

public class Select extends WMLTag 

{ 

public Select () { 

super ( "select" , true) ; 

} 

/* * 

* ©param name The name of the variable in which the device stores the value (s) associated^ 

with 

* the option (s) chosen by the user. The value associated with each option comes from the 

* &lt ;option&gt ; tag element value attribute. 

* ©param title Specifies a brief label for the &lt ; select&gt ; list. Some devices use thetf 

label 

* as a title when displaying the &lt ; select&gt ; content. Others mj_ght use it as a label ^ 

for a user 

* interface mechanism that lets the user navigate to the &lt ; select&gt ; content. For * 

0 example, if a 

.jg * device cannot display all card content on one screen and ordered= " true" (see Order ^ 
^ options) , the 

W * UP. Browser uses the title to identify this select list on a summary-level menu. 
~"-4 * ©param multiple Specifies whether the user can select multiple items. 

a*= public Select (String title, String name, boolean multiple) { 
^ thisO; 

""^ addAttribute ("title", title) ; 

ill addAttribute ( "name" , name) ; 

:~ addAttribute ( "multiple" ," " + multiple) ,- 

{11 public void addChi Id (WMLTag child) throws Inval idTagExcept ion { 

if (child instanceof Option || child instanceof OptGroup) 
]:z super .addChi Id (child) ; 

'■-J; else 

f3 throw new Inval idTagExcept ion ( "Select only supports OptGroup or Option children * 

tags") ; 

1 } 

public void addOpt ion (Option option) { 
try { addChild (option) ,* } 
catch (Inval idTagExcept ion e) {} 

} 

/ * * 

*@param defaultValue A string specifying the default value (s) for the variable specified 
by 

* the name attribute. 
*/ 

public void setDef aultValue (String defaultValue) { 

addAttribute ( "value" , defaultValue) ; //TODO what is the proper attribute? "value"? 

} 

/ * * 

* ©param iname Identical to the name attribute except for the following: The specified 

* variable stores the index value (s) associated with the option (s) chosen by the user. * 

The 

* index value associated with each option comes from its position in the <i>select</i> \l 

list, 

* starting with 1. If the user has not selected an option, the index value is 0. The 

default 

* value is specified by the ivalue attribute. 
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* Oparam ivalue Identical to the default attribute except for the following: The ^ 

specified 

* string contains the default index value (s) for the variable specified by the iname * 

attribute. 

*/ 

public void set INameAndlValue (String iName, String iValue) { 
addAttribute ( "iname " , iName ) ; 
addAttribute ( "ivalue", iValue) ; 

} 

public void setTablndex ( int tablndex) { 

addAttribute ( " tablndex" , " " + tablndex) ; 

} 

} 
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package com. thinairapps . tag . wml ; 
I * * 

* Used to reset all variables within a deck's current context. 
*/ 

public class Reset extends WMLTag 

{ 

public Reset 0 

{ 

super ("Reset", false) ; 

} 

} 
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package com. thinairapps . tag . wml ; 
/ * * 

* A utility class that reformats characters, such as <,>,', &, $, etc. which are 

reserved for 

* use by WML/ WAP , and that must been encoded in all uses 
* 

* ©author kleemax 

*' 

public class ReservedCharacter ( 

public final static String QUOTE = "squot;" ; 

public final static String LESS_THAN = "<" ; 

public final static String GREAT ER_THAN = "> M ; 

public final static String APOSTROPHY = "&apos; n ; 

public final static String AMPERSAND = "&"; 

public final static String DOLLARS I GN = *'$$"; 

public final static String SOFT_HYPHEN = "­ M ; 

public final static String NON_BREAKING_SPACE = " "; 

public final static String TRADEMARK = " (TM) " ; 

public final static int ESCSEQ_LENGTH = 6; 

/♦♦Processes inText, returning it's substring from inStart so that it is no 

* longer than inLength, and has inTail tacked on if it was longer. All of 

* the special characters in inText are reformatted to Markup Language Escape 
X2 * Sequences. If inTail is not null, then it is tacked onto the end of strings 
*y * which are too long, to show that the string is incomplete. Empty String "" 
sr* * is returned if inText is null or " " , if inStart is invalid, or if inLength 
?^ * is <= 0. 

* ©param inText the raw text that we will clip and encode 

! \ I * 

1^1 * ©param inStart the starting offset in inText from which we should start the 
^ * returned string- Nothing before inStart will be included in the return string. 

ffl * 

* ©param inLength the approximate number of characters that we would like our 

i«s * returned string to be. the returned string may be slightly more than inLength 

;^ * if it ends in an escape sequence. 

0 * ©param inTail if inTail is not null or " " , then it will be tacked onto the 

1 = * end of the returned string if we do not all of inText from inStart on. 

u ' * BEWARE: inTail does NOT get URL encoded and Escaped. Make sure that it doesn't 

M * contain special characters. 

* ©param outLengthUsed is a call -by- reference parameter. Pass in a non-null 

* int array at least 1 long if you wish to know the number of characters from 

* inText that were actually used in building the return String. 

* outLengthUsed [0] will contain the number of chars from inText which were 

* actually used or escaped in the returned string. This is NOT the length of 

* the returned String. Instead, it is the length of inText that was used in 

* building the returned String. 
* 

* ©return a string that starts from start and is no longer than length, with 

* all of the special characters escaped out. 
* 

* TODO: in the future, this method should look into having a parameter that 

* lets us break on words, rather than just breaking on length. (i.e.: do it 

* word by word, so we don't have incomplete words.) 
*/ 

public static String clipAndEncode (String inText, int inStart, int inLength, 

String inTail, int [] outLengthUsed) { 
// Deal with the case when we get bad parameters in 
if (inText == null || inText . length ( ) == 0 | | inStart < 0 || 
inLength <= 0 | j inStart inText . length {) ) { 
if (outLengthUsed != null) { 
outLengthUsed [0] = 0 ; 

} 

return " " ; 

} 
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// Local variables 

StringBuffer buff = new StringBuff er ( inLength) ; 
int length = inText . length () , 

used - 0 , 

charsVisited = 0; 
char current ,- 

boolean usingTail = false; 

// Check to see if we need to use the tail 
if (inTail != null && inTail . length ( ) > 0) { 

// add the tail if it is specified 

usingTail = true; 

inLength - = inTail . length () ; 

} 

// Loop around char by char, inserting the chars into the buffer, 
while (charsVisited < inLength && inStart < length) { 
used++ ; 

current = inText . charAt ( inStart ) ; 

switch (current) { 
case ' & 1 : 

buff .append (AMPERSAND) ; 

charsVisited += AMPERSAND . length {) ; 

break ; 
case ' " ' : 

buff . append (QUOTE) ; 

charsVisited QUOTE . length () ; 

break ; 
case 1 < ' : 

buff . append (LESS_THAN) ; 

charsVisited += LESS_THAN . length () ; 

break ; 
case ' > • : 

buff . append (GREATER_THAN) ; 

charsVisited += GREATER_THAN . length ( ) ; 

break; 

case 39: //the ' apostrophy 

buff . append (APOSTROPHY) ; 

charsVisited += APOSTROPHY . length () ; 

break ; 
case 1 $ 1 : 

buff .append (DOLLARS IGN) ; 

charsVisited += DOLLARS IGN . length () ; 

break ; 
case ' \n ' .* 

buff . append ( ' ' ) ; 

charsVisited++ ; 

break; 
case 1 \r 1 : 

buff . append ( ' ' ) ; 

charsVisited++ ,- 

break; 

case 8482: //the trademark symbol 
buff .append (TRADEMARK) ; 
charsVisited += TRADEMARK . length () ; 
break; 

case 180: // the forward apostrophe 

buff . append (APOSTROPHY) ; 

charsVisited += APOSTROPHY . length () ; 

break ; 
default : 

buff . append (current ) ; 

charsVisited++ ; 

break ; 

} 

inStart++ ; 

} 
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// Add the tail if it was called for, and we didn't iterate over the 
// whole length 

if (usingTail && inStart < length) { 
buf f -append (inTail) ; 

} 

// Now report the length used if it is asked for (by passing 
// in a non-null outLengthUsed 

if (outLengthUsed null && outLengthUsed . length > 0) { 
outLengthUsed [0] = used; 

} 

return buf f . toString ( ) ; 

// Should this be . trim() trimmed? 

} 

} 
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package com . thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException; 

/** 

* The &lt ; ref resh&gt ; element is a task element that instructs the device to refresh the *r 
specified card variables. The device also refreshes the display if any of those variables/ 
are currently shown. 

*/ 

public class Refresh extends Task 

public Refresh () { 

super ( "ref resh" , true); 

} 

public Ref resh (boolean closing) { 
super ( "ref resh" , closing) ; 

} 

public void addChild (WMLTag child) throws InvalidTagException { 
if (this . isClosedTag ( ) ) 

if (child instanceof SetVar) 
super .addChild (child) ; 

else 

throw new InvalidTagException ( "Ref resh only supports SetVar children tags"); 

IsJ * else 

throw new InvalidTagException ( "Tag must be a closing tag to support children"); 



} 
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package com. thinairapps . tag .wml ; 

import com. thinairapps . tag . InvalidTagException; 

I * * 

* The <prev> element is a task element that instructs the device to remove the current ^ 

URL from 

* the history stack and open the previous URL. If no previous URL exists on the history stacks 

, specifying <prev> has no effect. 

*/ 

public class Prev extends Task 

{ 

/♦Constructs a new Prev tag. 



*/ 

public PrevO { 



super ( "prev" , true ) ; 

} 



/♦Constructs a new opening or closing Prev tag, depending on the 'closing 1 parameter. 



* 



public Prev (boolean closing) { 
super ( "prev" , closing) ; 

} 



kQ public void addChild (WMLTag child) throws InvalidTagException { 

ir% if (this . isClosedTag ( ) ) 

J*:. if (child instanceof SetVar) 

"~-4 super .addChild (child) ; 

.fl else 

1*1 throw new InvalidTagException ( " Prev only supports SetVar children tags") ; 

l~z else 

^ throw new InvalidTagException ( "Tag must be a closing tag to support children"); 
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package com. thinairapps . tag . wml ; 
/ * * 

* The <postf ield&gt ; element defines name/value pairs that are passed to the HTTP server * 

receiving 

* the <go> request. See the <go> element for an example of the &lt ;postf ield&gt ; * 

element ' s use 

* in WML. 
*/ 

public class PostField extends WMLTag 
{ 

/ * * 

*@param name A label that identifies the field. 

*@param value A string specifying the default value for the variable specified by the * 
value attribute. 

*/ 

public PostField (String name, String value) { 
super ( "postf ield" , false) ; 
addAt tribute ( "name" , name) ; 
addAttribute ( "value" , value) ; 

} 

} 



if* 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag . Inval idTagExcept ion; 

/** 

* A WML Widget used to create a card with a labeled text input using a Password "*" mask. 

For constructor details, 

* see Card. 
*/ 

public class PasswordlnputCard extends Card 
{ 

public PasswordlnputCard ( ) 
super.O ; 

public PasswordlnputCard (String id) 
super (id) ; 

public PasswordlnputCard (String id, String title) 
super (id, title) ,- 

public PasswordlnputCard (String id, String title, boolean newContext) 
super (id, title, newContext) ; 

public PasswordlnputCard (String id, String title, boolean newContext, boolean ordered) 
super ( id, title , newContext , ordered) ; 



' z£- / * * 

IJ1 *@param href the link to submit the input to 

O *@param label the text label to display next to the input 

■~ *@param the name of the field 

'"'tl *@param the format to use for the field (*M,n) 
P */ 

public void buildCard (String href, String label, String name, String format) throws 
Inval idTagExcept ion 



{ 



Do dol = new Do (Do . TYPE_ACCEPT, new Go (href , false )) ; 
addChild(dol) ; 

Paragraph p = new Paragraph ( ) ; 
p.addChild(new Text (label) ) ; 
Input input = new Input (name); 
input . setType ( "password" ) ; 
input . set Format (format ) ; 

input . setvalue ( nn ) ,- // parksan (l0/17/2k) 

p . addChild (input ) ; 
addChild(p) ; 



- added this to remove caching 



I * * 

* ©param href the link to submit the input to 

* ©param label the text label to display next to the input 

* ©param name the name of the field 

* ©param format the format to use for the field (*M,n) 

* ©param extraFields an array of PostFields posted to the server along with the user's 

form input 

*/ 

public void buildPostCard (String href. String label. String name, String format. 




C: \TASS\ThinAirServer\ . . \thinairapps\tag\wml\PasswordInputCard . java 2 

PostField[] extraFields) 

Go goa = new Go (href, true, Go . METHOD_POST) ; 
goa .addChild (new Post Field (name , n $"+name) ) ; 

if (extraFields != null) 

for (int i = 0 ; i < extraFields . length; i++) 
goa . addChild (extraFields [i] ) ; 

} 

Do dew = new Do (Do . TYPE_ACCEPT / goa) ; 
addChild (dew) ; 

Paragraph p = new ParagraphO; 
p. addChild (new Text (label) ) ; 
Input input = new Input (name) ,- 
input . setType ( "password" ) ; 
input . setFormat ( format ) ; 

input . setValue ("") ; // parksan (10/17/2k) - added this to remove caching 

p. addChild (input) / 
addChild (p) ; 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException; 

/ * * 

* The <p> tag element specifies a new paragraph and has alignment and line-wrapping * 
attributes . 

*/ 

public class Paragraph extends WMLTag 
{ ♦ 

public final static String ALIGN_LEFT = "left"; 
public final static String ALIGN_CENTER = "center"; 
public final static String ALIGN_RIGHT = "right"; 

public final static String MODE_WRAP = "wrap" ; 
public final static String MODE_NOWRAP = "nowrap"; 

publ i c Paragraph ( ) 

{ 

super ( "p" ) ; 

} 

/* * 

* ©param align (ALIGN_LEFT, ALIGN_CENTER, AL I GN__R I GHT ) Specifies line alignment relative 
to the display area. Specifying & It ; p&amp ,*gt ; without the align attribute resets 

0 the line to left alignment. 

*0 * @param mode (MODE_WRAP / MODE__NOWRAP ) Specifies text wrapping mode to use. If you v£ 
i'-ri specify nowrap, the device uses another mechanism, such as horizontal scrolling, to 

l^l display long lines to the user. The device continues to use the mode you specify 

! jf until you specify a & It ; p&amp ,-gt ; element with the other mode. 

s p */ 

1 A public Paragraph (String align. String mode) 

\" { 

,2 this () ; 

\U addAttribute ( "align" , align) ; 

= addAttribute { "mode" ,mode) ; 
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package com. thinairapps . tag . wml ; 

import com . thinairapps . tag . Inval idTagExcept ion; 
/ * * 

* The &lt ;option&gt ; tag element specifies a particular choice within a <i>select</i> tag 
element . 

*/ 

public class Option extends WMLTag 

public Option () { 

super ( "option" ) ,- 

} 

I * * 

* ©param value Specifies the value to assign to the variable defined in the <i>select</i ^ 

> tag 

* element name attribute if the user selects the option (see example) . If you specify a 

* variable reference, the device evaluates the reference before setting the name variables 

*/ 

public Option (String value) { 
thisO; 

addAt tribute { "value" , value) ; 

} 

, j=| / * * 

iS * ©param title A label that identifies the option. The UP. Browser uses the title as the 

* ACCEPT key label when the user selects the option. To ensure compatibility on a wide 
"H * range of devices, label should be a maximum of five characters. 

s g * ©param value Specifies the value to assign to the variable defined in the <i>select</i *£ 
U* > ta 9 

* element name attribute if the user selects the option (see example) . If you specify a 

'H * variable reference, the device evaluates the reference before setting the name variables 

7 */ 

i^-. public Option (String title, String value) { 
M this (value) ; 

Ifl addAttribute ( "title" , title) ; 

5 } 

s -_s. / * * 

• * ©param title A label that identifies the option. The UP. Browser uses the title as the 

* ACCEPT key label when the user selects the option. To ensure compatibility on a wide 

* range of devices, label should be a maximum of five characters. 

* ©param value Specifies the value to assign to the variable defined in the <i>select</i * 

> tag 

* element name attribute if the user selects the option (see example) . If you specify a 

* variable reference, the device evaluates the reference before setting the name 

variable . 

* ©param label the text to be used as the displayable option 
*/ 

public Option (String title, String value, String label) { 
this(title, value); 
setLabel (label) ; 

} 



/ * * 

* ©param onPick Specifies the URL to open if the user selects the option (or deselects it 

* if the <i>select</i> element allows multiple choices) . This attribute represents an 

* abbreviated form of the &lt ; onevent&gt ; element. 
*/ 

public void setOnPick (String onPick) { 
addAttribute ( "onpick" , onPick) ; 

} 
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/** 

*@param label the text to be used as the displayable option 
*/ 

public void setLabel (String label) throws InvalidTagException { 
addChild(new Text (label) ) ; 

} 

public void addChild (WMLTag child) throws InvalidTagException { 
if (child instanceof Text | | child instanceof OnEvent) 
super . addChild (child) ; 

else 

throw new InvalidTagException ( "Option only supports Text or OnEvent children 
tags") ; 

} 
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package com . thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagExcept ion; 

/** 

* The <optgroup> element allows you to group multiple &lt ;opt ion&gt ; (or nested 

* &lt ,*optgroup&gt ; ) elements within a card. Creating option groups lets you specify control 

* information about how the device should present the card content. 
*/ 

public class OptGroup extends WMLTag 

{ 

public OptGroup () { 



/ * * 

* ©param title Specifies a brief label for the &lt ; optgroup&gt ; group. Some devices use 

* the label as a title when displaying the &lt ;optgroup&gt ; content. Others might use it 

* as a label for a user interface mechanism that lets the user navigate to the 

* &lt ;optgroup&gt ; content. 
*/ 

public OptGroup (String title) { 
super ("optgroup 11 ) ; 
addAttribute ("title", title) ; 



super ( "optgroup" ) ; 




/* 

*@param child a Tag of type Option or OptGroup 
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package com . thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException; 

/ * * 

* The &lt ;onevent&gt ; element associates a state transition, or intrinsic event, with a task * 

. When the 

* intrinsic event occurs, the device performs the associated <onevent> task. 
*/ 

public class OnEvent extends WMLTag 
{ 

public final static String TYPE_ON_PICK = "onpick" ; 

public final static String TYPE_ON_ENTER_FORWARD = "onenterf orward" ; 
public final static String T Y P E_ON_E NT E R_B AC KWARD = "onenterbackward" ; 
public final static String TYPE_ON_TIMER = "ontimer" ; 

/ *★ 

* ©param type Identifies the intrinsic event that triggers the specified <onevent> task *r 

( see 

* descriptions below). If a card-level <onevent> element (i.e. defined within a <card> 

element ) 

* has the same type as a deck-level <onevent> element (i.e. defined within a <template> * 

element) , 

* the card-level binding overrides the deck-level binding. 
*/ 

i-J public OnEvent (String type) { 
ip super ( "one vent " ) ; 

addAt tribute ( "type" , type) ; 

!J } 

-M public void addChild (WMLTag child) throws InvalidTagException { 
IjI if (child instanceof Task) 

: rt ! super. addChild (child) ; 

^ else 

|fl throw new InvalidTagException ( "OnEvent only supports Task children tags") ; 
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package com. thinairapps . tag . wml ; 

/** 

* The &lt ,*noop&gt ; element is a task element that instructs the device to do nothing, i.e 

. "no operation . " 

* This element is useful for overriding deck-level <do> elements, called shadowing (see the ^ 

UP . SDK 

* Developer's Guide for more information on shadowing) . 
*/ 

public class NoOperation extends Task 

public NoOperation { ) { 
super ( "noop" , false) ; 

} 

} 
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package com. thinairapps . tag . wml ; 
I * * 

* An insertable space ( ) 
*/ 

public class NonBreakingSpace extends Text 

public NonBreakingSpace ( int number) { 
super ( " " ) ; 



} 



} 



for (int i = 0; i < number; i + +) 
setName (getName ( ) + " &nbsp ; " ) ; 
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package com. thinairapps . tag . wml ,- 

import com. thinairapps . tag . I nvalidTag Except ion; 

* A WML widget which creates a card with multiple <i>xnput</i> tags. The WAP 

* Browser will either display this as a single card with "popup" input 

* fields, or as multiple cards which the user steps through. 
*/ 

public class Mult iplelnputCard extends Card 
{ 

public MultiplelnputCard ( ) { 
super () ; 

} 

/♦♦Constructs a new MultiplelnputCard with the given name (id) . 
* 

♦ ©param id specifies a name for the card 
*/ 

public MultiplelnputCard (String id) { 
super (id) ; 

} 

/♦♦Constructs a new MultiplelnputCard with the given name ('id') and label ('title') 
O attributes . 

t_n * 

£ JL ♦ ©param id specifies a name for the card 

— 1 * ©param title specifies a brief label for the card 

H */ 

,g public MultiplelnputCard (String id, String title) { 
si; super (id, title) ; 

^ } 

ffi /♦♦Constructs a new MultiplelnputCard with the given name (id) , label (title) and 

1 newcontext ' attributes. 

1= * ©param id specifies a name for the card 

M ♦ ©param title specifies a brief label for the card 

fll ♦ ©param newContext specifies whether the device should initialize the context whenever 

5*== the user naviages to the card through a <go/> task 

% */ 

*>*2 public MultiplelnputCard (String id, String title, boolean newContext) { 
!□ super ( id, title , newContext ) ; 

i* > 

/♦♦Constructs a new MultiplelnputCard with the given name ('id'), label * 
{'title'), 'newcontext* attributes, 

♦ and 'ordered' attributes. 
* 

♦ ©param id specifies a name for the card 

♦ ©param title specifies a brief label for the card 

♦ ©param newContext specifies whether the device should initialize the context whenever 

the user naviages to the card through a &lt,*go/> task 

♦ ©param ordered specifies the organization of card content 

*/ 

public MultiplelnputCard (String id, String title, boolean newContext , boolean ordered) { 
super ( id, title, newContext , ordered) ; 

} 

/ * * 

♦ ©param href the url to pass the result of the form input to 

♦ ©param acceptLabel the text label to use on the accept button ("save", "submit", etc) 

♦ ©param method the method to use to submit the form data to the server ( "POST" , "GET" ) 
*/ 

public void buildCard (String href, String acceptLabel , Labeledlnput [ ] inputs , String 
method) throws InvalidTagExcept ion 

{ 

buildCard (null , href , acceptLabel, inputs , method) ; 

} 
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public void buildCard (String header, String href, String acceptLabel , Labeledlnput [ ] * 
inputs, String method) throws I nvalidTag Except ion 

{ 

buildCard (header, href, acceptLabel, inputs, method, null); 

} 

I * * 

* ©param header text to be displayed at the top of the form 

* ©param href the url to pass the result of the form input to 

* ©param acceptLabel the text label to use on the accept button ("save", "submit", etc) 

* ©param method the method to use to submit the form data to the server ( "POST" , "GET" ) 
*/ 

public void buildCard (String header, String href, String acceptLabel, Labeledlnput [ ] 
inputs, String method, PostFieldt] hiddenFields) throws InvalidTagException 

{ 

Paragraph p = new Paragraph () ; 

boolean closingGo = false; 

if (method. equals (Go. METHOD_POST) ) 
closingGo = true; 

Go gol = new Go(href, closingGo, method) ,- 
Do dol = new Do (Do . TYPE_ACCEPT, gol ) ; 

iS dol . addAttribute ( " label " , acceptLabel ) ; 

if ( method. equal s( Go. METHOD_POST) ) 

s gr for (int i = 0; i < inputs . length; i++) 

\\l gol .addChild(new PostField (inputs [i] .getlnputName {), "$" + inputs[i]. ^ 

getlnputName ( ) ) ) ; 

ifl if (hiddenFields != null && hiddenFields . length > 0) 

[" for (int i = 0; i < hiddenFields . length; i++) 

gol. addChild (hiddenFields [i] ) ; 

U ] 

Q p. addChild (dol) ; 

|*j if (header != null) 

|„e_ p .addChild (new Text (header) ) ,* 

p .addChild (new Break ()) ; 

} 

for (int i = 0; i < input s . length ; i++) 
p. addChild (inputs [i] ) ; 

addChild (p) ; 

} 

} 
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package com . thinairapps . tag . wml ; 
/ * * 

* The &lt,*meta> element provides meta information for a WML deck. This element is * 

specified 

* within the deck header along with any access control information for the deck (for more 

* information, see &lt ,-access&gt ; element and &lt ; head&gt ; element) . Note that not all 

devices 

* support every meta information type. 
*/ 

public class Meta extends WMLTag 
{ 

public final static String PROPERTYJSTAME = "name"; 

public final static String PROPERTY_HTTP_EQUIV = "http-equiv" ; 

public final static String PROPERTY_USER_AGENT = "user-agent"; 

public final static String PRO PERT Y_USER_AGENT_MARKABLE = " vnd . up . markable " ; 
public final static String PRO PERT Y_USER_AGENT_BOOKMARK = " vnd . up . bookmark" ,- 

/** 

* ©param propertyType the attribute name to use with this Meta tag (i.e. name, http-equivtf 

, etc) 

* ©param propertyValue the value for the attribute indicated in propertyType 

* ©param content Specifies the metadata value associated with the property attribute. 

*/ 

Q public Meta (String propertyType , String propertyValue , String content) { 
tfi super ( "meta" , false) ,- 

^~ addAttribute (propertyType, propertyValue) ; 

^ addAttribute ( "content ", content) ; 

^ } 

J. /** 

* ©param forua (true | false) Specifies that the author intended the property to reach 
N the 

iS * user agent. If f orua= " false " , an intermediate agent must remove the &lt ;meta&gt ; * 
element 

* before the document is sent to the client. If the value is "true", the metadata of the 
I J. * element must be delivered to the user agent. The method of delivery may vary. For 

In example, 

;k * http-equiv metadata may be delivered using HTTP or WSP headers. 
;S */ 

public void setForua (boolean forua) 

0 { 

= s addAttribute ( " forua" , " " + forua) ; 

1 ) 

/*See specific WAP browser documentation for information about support for this attribute 

* of the Meta tag. 
*/ 

public void setScheme (String scheme) 

{ 

addAttribute ( "scheme" , scheme) ; 

> 

} 



C: \TASS\ThinAirServer\ . . \com\ thinairapps\tag\wml\Labeled!nput . java 



1 



package com. thinairapps . tag . wml ,- 
/ ** 

* An &lt ; input&gt ; tag with a text label next to it. See the Label class for more informations 
on the arguments . 

*/ 

public class Labeledlnput extends Input 
{ 

String label; 
I * * 

* ©param label the text label to use with this Input tag 
*/ 

public Labeledlnput (String name, String label) { 
super (name) ; 
this. label = label; 

} 

/** 

* ©param label the text label to use with this Input tag 
*/ 

public Labeledlnput (String name, String type, String format , String label) 

{ 

super (name , type, format ) ; 
this. label = label; 

i V' 1 

, ™ i * * 

* ©param label the text label to use with this Input tag 

'4 */ 

public Labeledlnput (String name, String title, String type, String format , String value, 
j'l String defaultValue , String label) { 

l^t super (name, title , type , format , value, defaultValue) ,- 

'^4 this, label = label; 

■ /* * 

M * ©param label the text label to use with this Input tag 
III */ 

public void setLabel (String label) { 
™ this. label = label; 

!= } 

= public String getLabel ( ) { 
return label; 

} 

public String render () { 

return label + super . render ( ) ; 

} 

} 
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package com. thinairapps . tag . wml ,* 

/** . . 

* The &lt ; input &gt ; element lets the user enter text which the device assigns to a specified / 

variable . 

*/ 

public class Input extends WMLTag 
{ 

public final static String TYPE_TEXT = "text"; 

public final static String TYPE_PASSWORD = "password" ; 

public final static String FORMAT_UCASE_ALPHA = "A"; 

public final static String FORMAT_LCASE_ALPHA = "a"; 

public final static String FORMATJSfUMERIC = "N" ; 

public final static String FORMAT_ANY_UCASE = "X" ; 

public final static String FORMAT_ANY_LCASE = "x" ; 

public final static String FORMAT_ANY_UCASE_CHANGEABLE = "M" ; 

public final static String FORMAT_ANY_LCASE_CHANGEABLE = "m 



/ ** 

*@param name The name of the variable in which the device stores the text entered by the/ 
user. 

*/ 

public Input (String name) 

W super ( "input false) ; 

* p addAt t r ibu t e ( " name " , name ) ; 

"~4 / * * 

:C *@param name The name of the variable in which the device stores the text entered by the/ 
Ui user. 

iram title Specifies a brief label for the input item. Some devices use the label as a/ 
tooltip when displaying the input field. Others might use it as a label for a user / 
interface mechanism that lets the user navigate to the item. For example, if a devices 
cannot display all card content on one screen' and ordered="true" (see Order / 
options), the UP. Browser uses the title to identify this input item on a / 
summary- level menu . 

*@param type (text | password) Specifies how the device should display text the user / 
enters. Specifying type="text" causes the text to be visible. Specifying type / 
= "password" causes the text to be masked (for example, replaced by "*" characters) . / 
Note that the password mode is not encrypted so you should not rely on it for / 
securing critical data. 
*@param format Specifies a data format that the user entry must match (see Specifying a / 
format mask below) . If you omit this attribute, the device assumes *M (default / 
uppercase first character followed by up to maxlength number of mixed case alphabetic/ 
and numeric characters) . 

*/ 

public Input (String name, String type, String format) { 
this (name) ; 

addAt tribute ( "type" , type) ; 
se t Format (format ) ,- 

} 

/ * * 

*@param name The name of the variable in which the device stores the text entered by the/ 
user. 

*@param title Specifies a brief label for the input item. Some devices use the label as a/ 
tooltip when displaying the input field. Others might use it as a label for a user / 
interface mechanism that lets the user navigate to the item. For example, if a device/ 
cannot display all card content on one screen and ordered= "true" (see Order / 
options), the UP. Browser uses the title to identify this input item on a / 
summary- level menu. 

*@param type (text | password) Specifies how the device should display text the user / 
enters. Specifying type="text" causes the text to be visible. Specifying type / 
= "password" causes the text to be masked (for example, replaced by "*" characters). / 
Note that the password mode is not encrypted so you should not rely on it for / 
securing critical data. 
*@param format Specifies a data format that the user entry must match (see Specifying a / 
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format mask below) . If you omit this attribute, the device assumes *M (default * 
uppercase first character followed by up to maxlength number of mixed case alphabetic 
and numeric characters) . 
*@param value Specifies the value of the variable named in the name attribute. When the * 
element is displayed and the variable named in the name attribute is not set, the \£ 
name variable is assigned the value specified in the value attribute. If the name 
variable already contains a value, the value attribute is ignored. 

*/ 

public Input (String name, String title, String type, String format, String value, String^ 
defaultvalue) 

{ 

thi s ( name , type , format ) ,- 
addAttribute ("title", title) ; 
addAt tribute ("value", value) ; 
addAttribute ( "default " , def aultValue) ; 

} 

/ * * 

*@param type (text | password) Specifies how the device should display text the user yr 
enters. Specifying type=" text 11 causes the text to be visible. Specifying type 
= "password" causes the text to be masked (for example, replaced by "*" characters) . 
Note that the password mode is not encrypted so you should not rely on it for * 
securing critical data. 

*/ 

public void setType (String type) 
O { 

iQ addAttribute ("type", type) ; 

/* 

*@param value Specifies the value of the variable named in the name attribute. When the * 
]\\ element is displayed and the variable named in the name attribute is not set, the * 

name variable is assigned the value specified in the value attribute. If the name ^ 
'-i variable already contains a value, the value attribute is ignored. 

m */ 

public void setValue (String value) 

U { 

^ addAttribute ( "value" , value) ; 

;2 /** 

us * @param emptyOk (true | false) Specifies whether the user can leave the field blank. 
|3 Specifying 

j-L * emptyok="true" indicates that the field is optional- -if the user enters a value, 
however, the 

* device applies any entry requirements you specify for the format attribute. 
*/ 

public void setEmptyOk (boolean emptyOk) 
addAttribute ( "emptyok" , " " + emptyOk) ; 

} 

/* . . 

*@param format Specifies a data format that the user entry must match (see Specifying a 

format mask below) . 

*If you omit this attribute, the device assumes *M (default uppercase first character) . 
*/ 

public void setFormat (String format) 
{ 

addAttribute ( " format " , format ) ; 

} 

/* 

*@param format Specifies a data format that the user entry must match (see Specifying a 
format mask below) . 

*If you omit this attribute, the device assumes *M (default uppercase first character * 

followed by up to 
♦maxlength number of mixed case alphabetic and numeric characters) . 

*/ 
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public void setFormat (String format, int max) 

{ 

addAttribute ("format" .max + format) ; 

} 

/*Sets the 'size' attribute for the Input tag. 
* 

*/ 

public void setSize (int size) 

addAttribute ( "size" , " " + size) ; 

} 

/** 

*@param maxlength Specifies the maximum number of characters the user can enter. If you 

do not specify the maxlength attribute, the UP. Browser imposes a limit of 256 < 
characters . 

*/ 

public void setMaximumLength (int maxLength) 

addAttribute ( "maxLength" , " " + maxLength) ; 

} 

/*Sets the 'tabindex 1 attribute for the Input tag. 
* 

Q */ 

public void setTablndex (int tabindex) 
IS addAttribute ( "tabindex" , » " + tabindex); 

H } 

l^i /*Returns the name of this Input tag. 
I M * 
H */ 

ifl public String ge t Input Name ( ) 

5 _ return getAttribute ( "name " ) . getValue ( ) ; 
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package com. thinairapps . tag . wml ; 
/** 

* The &lt ; image&gt ; element instructs the device to display an image within formatted text. * 
Note that not all devices can display images. 

*/ 

public class Image extends WMLTag 
{ 

public final static String ALIGN_TOP = "top"; 
public final static String ALIGN_MIDDLE = "middle"; 
public final static String AL I GN_BOTTOM = "bottom"; 

/ * * 

*@param src The URL of the image to display. If you specify a valid icon for the localsrc/ 

attribute (see below), the device ignores this attribute. 
*@param alt Specifies the text to display if the device does not support images or cannot 

find the specified image. 

*/ 

public Image (String src, String alt) { 
super ( " img " ) ; 
if (src null) 

addAttribute ( n src M , src) ; 

else 

addAttribute ( " src " , " " ) ; 

Q if (alt != null) 

ip addAttribute ("alt" ,alt) ; 

i-fz else 

lM addAttribute ( "alt" , " " ) ; 

N } 

5 " = / * * 

* ©param icon A class representing a known icon. If the device cannot find the icon in 
^ ROM (Read-Only Memory) , it attempts to retrieve it from the UP. Link Server. If you 

iO specify a valid icon (see Figure 2-6 for a list of icon names) , the device ignores * 

the src and alt attributes (see above) even though they are still required. 
]_ * ©param align alignment of image with text (ALIGN_TOP , ALIGN_MIDDLE , ALIGN_BOTTOM) 
^ * ©param alt Specifies the text to display if the device does not support images or * 

111 cannot find the specified image. 
□ */ 

public Image (Icon icon, String align, String alt) { 

112 this (null , alt ) ; 

O addAttribute ( "localsrc" , icon. getLocalSrc () ) ; 

addAttribute ( "align" , align) ; 

H } 
/ * * 

* ©param height the desired scaled height of the image 

* ©param width the desired scaled width of the image 
*/ 

public void setSizefint height, int width) 

{ 

addAttribute ( "height ", "" + height); 
addAttribute ( "width" , 11 ■■ + width); 

} 

J * * 

* ©param vspace the amount of space above and below the image 

* ©param hspace the amount of space to the left and right of the image 
*/ 

public void setSpace(int vspace, int hspace) 

{ 

addAttribute ( "hspace" ," " + hspace); 
addAttribute ( "vspace "," " + vspace); 

} 

} 
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package com. thinairapps . tag . wml ,- 
I * * 

* A utility class which represents the static strings used for indicating the names 

* of the built-in icons which some WAP phones support for use with the Image tag. Consult 

* the documentation for specific WAP browsers for more information. 
*/ 

public class Icon 
{ 

private String localSrc = null; 
/ * * 

* ©param localSrc the local icon name to be used 
*/ 

public Icon (String localSrc) 

{ 

this . localSrc - localSrc; 

} 

public String getLocalSrc ( ) { 
return localSrc; 

} 

public final static String EXCLAMATION1 = "exclamationl " ; 

public final static String EXCLAMAT I ON2 = M exclamation2 " ; 
)□ public final static String QUESTIONl = "quest ionl 11 ; 
• ~Q public final static String QUESTION2 = "quest ion2 " ; 

^ public final static String MAILBOX = "mailbox"; 

,E public final static String MAGNI FY_GIjASS = "magnif yglass " ; 

PI public final static String LOCK_KEY = "lockkey" ; 

fO public final static String INBOX = "inbox"; 
public final static String OUTBOX = "outbox" ; 

\J public final static String FOLDER_CLOSED = "folderl"; 
lp public final static String FOLDER_OPEN = "folder2 M ; 

public final static String CLOCK = "clock"; 

p public final static String PUSHPIN - "pushpin"; 

' public final static String DOCUMENT 1 = "documentl"; 

public final static String FLOPPY_DISK = "floppy!" ; 

public final static String CHECKMARK1 = "checkmark!. " ; 

public final static String PHONE_OLD = "phonel"; 
public final static String PHONE_HANDSET = "phone2"; 
public final static String PHONE_MOB I LE - "phone3"; 

public final static String ENVELOPE1 = "envelopel " ; 
public final static String ENVELOPE2 = "envelope2 " ; 

public final static String PAPERCLIP = "paperclip 11 ; 

public final static String PENCIL = "pencil"; 

public final static String ROLOCARD = "rolocard"; 

public final static String CALENDAR_MONTH = "calendar"; 
public final static String C AL E ND AR_D A Y = "day"; 
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package com . thinairapps . tag . wml ,- 

import com. thinairapps . tag . InvalidTagException; 

/** 

* The <head> element specifies information about the deck as a whole, including *r 
metadata and access control information. 

*/ 

public class Head extends WMLTag 

{ 

public HeadO { 

super ( "head" ) ; 

} 

I -k * 

* ©param child a Tag to be added to this FieldSet . 

* ©exception com . thinairapps . tag . InvalidTagException if the tag is not an instance or 

subclass of classes Access or Meta. 

*/ 

public void addChi Id (WMLTag child) throws InvalidTagException { 
if (child instanceof Access | | child instanceof Meta) 
super . addChild (child) ,- 

else 

throw new InvalidTagException () ; 

} 



# 
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package com. thinairapps . tag . wml ; 

import com. thinairapps - tag . InvalidTagException,- 

I * * 

* The <go> element is a task element that instructs the device to open a specified URL \l 
. If the URL specifies a particular card, the device displays that card. If the URL 
specifies a deck, the device displays the first card in that deck. 

*/ 

public class Go extends Task 
{ 

public final static String METHOD_GET = "get"; 
public final static String ME THOD__ POST = "post" ; 

public final static String CHARS ET_DE FAULT = "UTF-8"; 

/★★★Constructs a standard Go Tag with the appropriate URL. 
* 

* ©param href The URL to which this Task should link 

* ©param closed a boolean indicating if there are to be children Tags 
*/ 

public Go (String href, boolean closed) { 
super ( "go" , closed) ; 
addAt tribute ( "href ", href ) ,- 
O addAttribute ( "sendreferer" , "true") ; 

]S /***Constructs a standard Go Tag with the appropriate URL and link method. 

* ©param href The URL to which this Task should link 

F" * ©param closed A boolean indicating if there are to be children Tags 
If: * ©param method This should be either ' Go . METHOD_GET 1 or "Go . METHOD_POST" 

'"""4 public Go (String href, boolean closed, String method) { 
IS super ("go" , closed) ; 

addAt tr ibute ( "href ", href ) ; 
E _ addAttribute ( "method" , method) ; 

0 addAttribute ( "sendreferer" , "true" ) ; 

If? /***Constructs a Go Tag with the appropriate URL and link method. 

1 j s * 

Q * ©param href The URL to which this Task should link 

sjl * ©param closed A boolean indicating if there are to be children Tags 

* ©param sendReferrer A boolean indicating if there deck URL should be included in the \l 

URL request 

* ©param method This should be either 1 Go . METHOD_GET 1 or "Go . METHOD_POST " 

* ©paran acceptCharset Specifies the device encoding you application can handle in a nr 

comma or space 

* delimited list, such as "UTF-8 , US-ASCII , ISO, 8859-1" . 

*/ 

public Go(String href, boolean closed, boolean sendReferer, String method, String vr 
acceptCharset) { 
this (href , closed) ; 

addAttribute ("sendreferer", "" + sendReferer); 
addAttribute ( "method" , method) ,- 

addAttribute ( "accept-charset " , acceptCharset) ; 

} 

/***Adds a PostField to this Go task. 
*/ 

public void addPostField (PostField postfield) throws InvalidTagException { 
addChildfpostf ield) ,- 

} 

/***Adds a PostField to this Go task with the specified value pre-set. 
*/ 

public void addPostField (String name, String value) throws InvalidTagException { 
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addPostField (new PostField(name, value) ) ; 

} 

} 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException; 

/ * * 

* The &lt ;f ieldset&gt ; element allows you to group multiple text or input items within a card/ 

. Specifying 

* one or more &lt ; f ieldset&gt ; elements lets you control how the device presents card content/ 

in order to 

* simplify user navigation. 
*/ 

public class FieldSet extends WMLTag 

{ 

public FieldSet () { 

super ( "fieldset " ) ; 

} 

/ ** 

* ©param title Specifies a brief label for the &lt ; f ieldset&gt ; group. Some devices use / 

the label as 

* a title when displaying the &lt ; f ieldset&gt ,- content. Others might use it as a label / 

for a user 

* interface mechanism that lets the user navigate to the &lt ; f ieldset&gt ; content. / 

Consult individual 

* WAP browser documentation for more details. 

3 */ 

Z public FieldSet (String title) { 
M this ( ) ; 

Ji addAttribute ("title" , title) ; 

4 > 

r* /** 

ti * ©param child a Tag to be added to this FieldSet. 

y * ©exception com. thinairapps . tag . InvalidTagException if the tag is not an instance or / 
^ subclass of classes Text, FieldSet, Input, or Select. 

* */ . 

_ public void addChi Id (WMLTag child) throws InvalidTagException { 

"1 if (child instanceof Text | | child instanceof FieldSet | | child instanceof Input | | / 

fz child instanceof Select) 

super . addChild (child) ; 

=J else 

throw new InvalidTagException () ; 
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package com. thinairapps . tag . wml ; 

import com . thinairapps . tag . InvalidTag Except ion ; 

/** 

* The <do> element associates a task with an element within the user interface (for \i 

example, a 

* function key, graphically- rendered button, or voice-activated command) . When the user * 

invokes the 

* user interface mechanism, the device performs the associated <do> element task. 
*/ 

public class Do extends WMLTag 

{ 



public 


final 


static 


String 


TYPE 


ACCEPT : 


= "accept"; 


public 


final 


static 


String 


type" 


DELETE : 


= "delete" ; 


public 


final 


static 


String 


type" 


HELP = 


"help" ; 


public 


final 


static 


String 


type" 


OPTIONS 


= "options 


public 


final 


static 


String 


type] 


~PREV = 


"prev" ; 


public 


final 


static 


String 


type" 


"reset - 


"reset" ,- 


public 


final 


static 


String 


type" 


"unknown 


_ rt ii . 


1 * * 















* ©param type Identifies the generic user interface mechanism that triggers the specified* 

&lt ;do&gt ; 

* element task (see descriptions below) . 

* ©param task Task tag to added as child 

*/ - 

public Do (String type, Task task) throws InvalidTagException { 
super ( "do" ) ; 

addAt tribute ( 11 type" , type) ,- 
addChild(task) ,- 

} 

/ ** 

* ©param type Identifies the generic user interface mechanism that triggers the specified* 

<do> 

* element task (see descriptions below) . 

* ©param task Task tag to added as child 

* ©param label A label that identifies the task with the user interface mechanism. For * 

example, if 

* you bind a task to the ACCEPT key, the device displays this value as the function key * 

label. If 

* you do not specify the label attribute, the device uses the word "OK" as the default * 

ACCEPT key 

* label. To ensure compatibility on a wide range of devices, label should be a maximum of* 

five 

* characters. Devices ignore the label attribute if they do not support dynamic labelling* 

* ©param name Specifies a name for the <do> element. If a card- level <do> * 

element (i.e. 

* defined within a &lt ; card&gt ; element) has the same name as a deck- level <do> * 

element (i.e. 

* defined within a &lt ; template&gt ; element), the card-level binding overrides the * 

deck- level binding. 

* ©param optional Specifies whether the device can ignore this element. 

*/ 

public Do (String type, Task task, String label, String name, boolean optional) throws * 
InvalidTagException { 
this (type , task) ; 
addAt tribute ("label", label) ; 
addAt tribute { "name" , name) ; 
addAt tribute ( "optional "," " + optional); 

} 

/ * * 

* ©param type Identifies the generic user interface mechanism that triggers the specified* 

&lt ;do&gt ; 

* element task. This should be one of the type constants defined in this class. 
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* ©param task Task tag to added as child 

* ©param label A label that identifies the task with the user interface mechanism. For * 

example, if 

* you bind a task to the ACCEPT key, the device displays this value as the function key \t 

label. If 

* you do not specify the label attribute, the device uses the word "OK" as the default 

ACCEPT key 

* label. To ensure compatibility on a wide range of devices, label should be a maximum oftf 

five 

* characters. Devices ignore the label attribute if they do not support dynamic labelling^ 

* ©param name Specifies a name for the &lt ; do&gt ; element. If a card- level <do> 

element (i.e. 

* defined within a &lt ; card&gt ; element) has the same name as a deck- level &lt,*do> 

element (i.e. 

* defined within a &lt ; template&gt ; element), the card-level binding overrides the ^ 

deck- level binding. 

* ©param optional Specifies whether the device can ignore this element. 

*/ 

public Do (String type, Task task, String label, boolean optional) throws 
InvalidTagException { 
this (type, task) ; 
addAttribute ( "label" , label) ; 
addAttribute ( "optional" , "false") ; 
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package com. thinairapps . tag . wml 

import com. thinairapps . tag . InvalidTagException; 
/ ** 

* A widget which extends Card and providers basic functionality for displaying a message and * 
a link 

V 

public class DisplayCard extends Card 

{ 

public DisplayCard () 
{ 

super ( ) ; 

} 

/♦♦Constructs a new Card with the given name ('id') attribute. 
* 

♦ ©param id specifies a name for the card 
*/ 

public DisplayCard (String id) 

{ 

super (id) ; 

} 

^ /**Constructs a new Card with the given name ('id') and label ('title 1 ) attribute. 

♦ ©param id specifies a name for the card 

\U ♦ ©param title specifies a brief label for the card 
*/ 

f» public DisplayCard (String id, String title) 
= =y super (id, title) ; 

;y } 

^ /♦♦Constructs a new Card with the given name ('id'), label ('title') and ' newcontext • *r 
; attributes. 

¥71 * ©param id. specifies a name for the card 

ifi * ©param title specifies a brief label for the card 

";fj * ©param newContext specifies whether the device should initialize the context whenever 
'-tJ the user naviages to the card through a <go/> task 

m */ 

i?n public DisplayCard (String id, String title , boolean newContext) 

^ super (id, title, newContext ) ; 

} 

/♦♦Constructs a new Card with the given name ('id'), label {'title'), 'newcontext', 

♦ and 'ordered' attributes. 
* 

♦ ©param id specifies a name for the card 

♦ ©param title specifies a brief label for the card 

♦ ©param newContext specifies whether the device should initialize the context whenever * 

the user naviages to the card through a <go/> task 

♦ ©param ordered specifies the organization of card content 
*/ 

public DisplayCard (String id, String title , boolean newContext , boolean ordered) 

{ 

super (id, title , newContext , ordered) ; 

} 

/ * * 

* ©param text the text you wish to display 

♦ ©param align the paragraph alignment to use for the next ( Paragraph . LEFT, Paragraph. *r 

CENTER , Paragraph . RIGHT ) 

*/ 

public void buildCard (String text, String align) 
{ 
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Paragraph p = new Paragraph (align, Paragraph . MODE_WRAP) ; 
p.addChild(new Text(text)); 
addParagraph (p) ; 



/ * * 

* ©param text the text you wish to display 

* ©param align the paragraph alignment to use for the next ( Paragraph . LEFT , Paragraph. 

CENTER, Paragraph . RIGHT) 

* ©param href the url to use with the "Ok" link on the Card 
*/ 

public void buildCard (String text, String align, String href) 
try { 

addChild(new Do (Do . TYPE_ACCEPT, new Go (href , false) )) ; 
Paragraph p = new Paragraph (align, Paragraph ,MODE_WRAP) ; 
p.addChild(new Text (text )) ; 
addParagraph (p) ; 

catch (InvalidTagExcept ion e) { 
e .printStackTrace ( ) ,- 

} 

} 

/ * * 

* ©param text the text you wish to display 

* ©param align the paragraph alignment to use for the next (Paragraph . LEFT, Paragraph. 

CENTER, Paragraph . RIGHT) 

* ©param href the url to use with the "Ok" link on the Card 

* ©param seconds the amount of time before the href link should be automatically loaded \l 

(uses setOnTimer ( ) ) 

*/ 

public void buildCard (String text, String align, String href, int seconds) 

^ Paragraph p = new Paragraph (align, Paragraph . MODE_WRAP) ; 
Timer timer = new Timer ( seconds) ; 
setOnTimer (href ) ; 
p . addChi Id (timer) ; 
p.addChild(new Text (text) ) ; 
addParagraph (p) ; 

} 



C : \TASS\ThinAirServer\ . . \com\thinairapps\tag\wml\Container . j ava 



1 



package com. thinairapps . tag . wml ; 
/** 

* A utility class solely used to group sets 

public 

* class as an implementaion detail. Do not 
*/ 

public class Container extends WMLTag 

public Container () { 
super ('* 11 , false) ; 

} 

public String render () { 

return renderChildren ( ) ; 



of WMLTag s together for rendering. This is * 
use this class in your applications. 
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package com. thinairapps . tag . wml ; 
import com . thinairapps . tag . * ; 
/ * * 

* A non-rendered portion of the page used to contain any extraneous information desired by 
the developer 

*/ 

public class Comment extends WMLTag { 

/♦♦Constructs a Comment with the given String. 
* 

* ©param text the comment to be added to the WML Deck 
*/ 

public Comment (String text) { 

super (" !-- " + text + " false ) ; 

} 

} 



# 
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package com- thinairapps . tag . wml ; 

import com. thinairapps . tag . I nvalidTag Except ion; 

/* * 

* A WML deck consists of one or more &lt ; card&gt ; elements, each of which specifies 

* a single interaction between the user and the device. 
*/ 

public class Card extends WMLTag 

public CardO { 

super ( "card" ) ; 

} 

/♦♦Constructs a new Card with the given name (id) . 
* 

♦ ©param id specifies a name for the card 
*/ 

public Card (String id) { 
thisO ; 

addAttribute ("id" , id) ; 

} 

/♦♦Constructs a new Card with the given name ('id') and label ('title') attributes. 
* 

„ ♦ ©param id specifies a name for the card 

3 ♦ ©param title specifies a brief label for the card 

0 */ 

in public Card (String id, String title) { 
; 1 this (id) ; 

'"2 addAttribute ("title", title) ; 

; P } 

"7i /♦♦Constructs a new Card with the given name (id), label (title) and 'newcontext 1 
W attributes . 

= * ©param id specifies a name for the card 

;==i ♦ ©param title specifies a brief label for the card 

:j! * ©param newContext specifies whether the device should initialize the context whenever nr 
■IP the user naviages to the card through a &lt,*go/> task 

□ */ 

ir% public Card (String id, String title , boolean newContext) { 

;1! this ( id, title) ,• 

IsJ addAttribute ( "newcontext "," " + newContext) ; 

/♦♦Constructs a new Card with the given name ('id'), label ('title'), 'newcontext' * 
attributes, 

♦ and 'ordered' attributes. 
* 

♦ ©param id specifies a name for the card 

♦ ©param title specifies a brief label for the card 

♦ ©param newContext specifies whether the device should initialize the context whenever 

the user naviages to the card through a <go/> task 

♦ ©param ordered specifies the organization of card content 
*/ 

public Card (String id, String title , boolean newContext , boolean ordered) { 
this ( id, title, newContext ) ; 
setOrdered (ordered) ; 

} 

/♦♦This attribute has different effects on different browsers. Consult your WAP browser 

♦ documentation for information about how ordered and unordered Cards are rendered. 
* 

♦ ©param ordered specifies the organization of card content. 
*/ 

public void setOrdered (boolean ordered) { 
addAttribute ( "ordered" , " " + ordered) ; 

} 
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I ★ * 

* ©param url specifies the URL to open if the user navigates to this card through a <tf 

go> task 

*/ 

public void setOnEnterForward (String url) { 
addAttribute ( "onenterf orward" , url ) ; 

} 

/ * * 

* ©param url specifies the URL to open if the user navigates to this card through a <tf 

prev> task 

*/ 

public void setOnEnterBackward (String url) { 
addAttribute { "onenterbackward" , url ) ; 

} 

I * * 

* ©param url specifies the URL to open if a specified &lt ; timer&gt ; element expires 
* / 

public void setOnTimer (String url) { 
addAttribute ( "ontimer" , url) ; 

} 

/**Adds a Paragraph to this Card. 

* ©param p Paragraph tag to be added 
*/ 

public void addPa rag raph ( Paragraph p) { 
try { addChild(p) ; } 
catch (InvalidTagExcept ion e) { 
e . printStackTrace ( ) ; 

} 

} 

/* * 

* ©param child WMLTag to be added 
*/ 

public void addChi Id (WMLTag child) throws InvalidTagExcept ion ( 



if (! (child instanceof OnEvent || child instanceof Timer | 
child instanceof Anchor | | child instanceof FieldSet 
| | child instanceof Input | | child instanceof Select 
Paragraph | | child instanceof Container) ) 
throw new Inval idTagExcept ion ( "invalid child tag"); 

else 

super -addChild (child) ; 



child instanceof Do | | ^ 
| child instanceof Image 
child instanceof 



} 
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package com. thinairapps . tag . wml ; 



/ * * 



* The <br/> element specifies a line break. For example, it causes the device to 
display the subsequent text or image on a new line. 

*/ 

public class Break extends WMLTag 

{ 

public Break () 



super ( "br 



false) ; 
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package com. thinairapps . tag . wml ,- 

/** 

* The <b> element specifies bold text. 
*/ 

public class Bold extends WMLTag 
{ 

/♦♦Constructs an empty Bold tag. 
* 

*/ 

public BoldO 

{ 

super ("b" , true) ; 

} 

/♦♦Constructs a Bold tag with the given WMLTag as a child. 
* 

*/ 

public Bold (WMLTag tag) 
{ 

thisO ; 

addChild(tag) ; 

} 

/♦♦Constructs a Bold tag with the given Text tag as a child. 
„_ * 

f */ 

y public Bold (String text) 
[~i this (new Text (text) ) ; 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag - Attribute ; 

import com. thinairapps . tag . InvalidTag Except ion ,* 

import java . util . Enumeration ; 

/ * + 

* anchor element: The &lt ; anchor &gt ,- element anchors a task to a string of formatted text, \£ 
often called a link. You can specify a link within any formatted text or image. When a ^ 
user selects the link and presses ACCEPT, the device executes the task. 

*/ 

public class Anchor extends WMLTag 

{ 

/ * * 

* ©param task represents the action to perform when the user activates the link and text *r 

is the text the device will display to represent the link. You must anchor one of thetf 
following task elements to a link: &lt,-go&gt ; , &lt ;prev&gt ; , &lt ; ref resh&gt ; , < 
spawn&gt ; , &lt ,-exit&gt ; , &lt ; throw&gt ; 

* ©param text Devices typically set this text off from surrounding text, for instance, *r 

by enclosing it in square brackets (see example) or underlining it if the device can \£ 
display bitmap images. 

*/ 

public Anchor (Task task, Text text) 

{ 

super ( "anchor" ) ; 
: _ addChild(task) ; 

J addChild(text) ; 

^ / * * 

'H * ©param task represents the action to perform when the user activates the link and text * 
t p is the text the device will display to represent the link. You must anchor one of thetf 

\-j following task elements to a link: &lt ; go&gt ; , &lt ; prev&gt ,- , &lt ; ref resh&gt ; , < 

;,1 spawn>, &lt ; exit&gt ; , &lt ; throw&gt ; 

."f * ©param text Devices typically set this text off from surrounding text, for instance, bywr 
iB enclosing it in square brackets (see example) or underlining it if the device can * 

display bitmap images . 

* ©param title A label that identifies the link. If you do not specify the title 
^ attribute, the device uses the word "Link" as the default label. 

(is */ 

13 public Anchor (Task task, Text text, String title) { 
is this (task, text ) ; 

addAttribute ("title", title) ; 

/ * * 

* ©param href url link for action 

* ©param title title displayed on button when selected 

* ©param generally child text to display as link 

*' 

public Anchor (String href , String title , WMLTag child) { 
super ( "a" ) ; 

addAttribute ( "href ", href ) ; 
if (title != null) 

addAttribute ( "title" , title) ; 
addChild (child) ; 

} 



/ * * 

* Used to add a child tag to this Anchor object. 

* ©param child A WMLTag object to add as a child of this tag 
*/ 

public void addChild (WMLTag tag) { 
try { super .addChild ( tag) ; } 
catch (InvalidTagException e) { 
e .printStackTrace ( ) ; 

} 

} 
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protected String renderOpenTag ( ) { 

StringBuffer output = new StringBuf fer () ; 

//render self open 
output . append ( '* < " ) ; 
output . append ( name ) ; 

Enumeration eAttribs - attributes . elements () ; 

while (eAttribs . hasMoreElements ( ) ) 

output .append ( " " + ( (Attribute) eAttribs . nextElement ()). render ()) ,* 

output . append ( " > " ) ; 

return output . toString () ; 

} 

protected String renderChildren ( ) { 

StringBuffer output = new StringBuf fer () ; 

Enumeration eChildren = children . elements () ; 

while (eChildren. hasMoreElements { ) ) 
,„ output .append (( (WMLTag) eChildren . nextElement () ) .renderO); 



} 



return output . toString () ; 



protected String renderCloseTag ( ) { 
if (closingTag) 

return " </" + name + " >" ; 

else 

return " " ; 

} 
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package com. thinairapps . tag . wml ; 

/** 

* The &lt ; access&gt ; element specifies access control information for a WML deck. 

* You must specify this element within the deck header along with any meta 

* information for the deck (for more information, see <head> element and 

* <meta> element). Each deck can have only one &lt ; access&gt ,- element. All 

* WML decks are public by default. 
*/ 

public class Access extends WMLTag 

{ 

public Access () { 

super ( "access" , false) ; 

} 

j * * 

* ©param domain The URL domain of other decks that can access cards in the 

* deck. The default value is the domain of the current deck. 

* / 

public void set Domain (String domain) { 
addAt tribute ( "domain" , domain) ; 

} 

/* * 

* ©param path The URL root of other decks that can access cards in the deck. 

* The default value is "/" (the root path of the current deck) which lets any 
■« E * deck within the specified domain access this deck. 

m */ 

itj public void setPath (String path) { 
l~i addAttribute ( "path" , path) ; 

2 } 



♦ # 
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package com. thinairapps . tag .wml . goWebRim; 

import com. thinairapps . tag .wml . * ; 

/** 

* The &lt ;input> element lets the user enter text which the device assigns to a specified * 
variable . 

*/ 

public class TextArea extends WMLTag 
{ 

public final static String TYPE_TEXT = "text"; 

public final static String TYPE_PASSWORD = "password"; 

public final static String FO RMAT_UC AS E_AL P HA = "A"; 

public final static String FORMAT_LCASE_ALPHA = "a"; 

public final static String FORMAT_NUMER I C = "N" ; 

public final static String FORMAT_AN Y_UC AS E = "X" ; 

public final static String FORMAT_ANY_LCASE = "x" ; 

public final static String FORMAT_ANY_UCASE_CHANGEABLE = "M" ; 

public final static String FORMAT_ANY_LCASE_CHANGEABLE = "m" ; 

public TextArea (String name) 

{ 

super ( "textarea" , true) ,- 
addAt tribute ( "name" ,name) ; 

13 } 

'' 0 / * * 

i'fi * ©param name the unique id of this element 
l]% * ©param rows the number of rows 
5 * ©param cols the number of columns 
s p */ 

|=1 public TextArea (String name,int rows,int cols) { 

super ( "textarea" , true) ; 
.""f addAt tribute ( "name" , name) ; 



addAt tribute ( "rows" , " " + rows) ; 
addAttribute ( "cols" , " " + cols) ; 



* ©param text set the text value for this element 
*/ 

public void setValue (String text) { 

get Children ( ) . removeAHElements ( ) ; 
getChildren ( ) . addElement (new Text (text) ) ; 

} 
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package com. thinairapps . tag . wml .goWebRim; 

/** 

* An < input&gt ; tag with a text label next to it. See the Label class for more information/ 

on the arguments. 

* This class is to be used with the Go Web browser. 
*/ 

public class Label edText Area extends TextArea 
{ 

String label ; 
I * * 

* ©param label the text label to use with this TextArea tag 
*/ 

public Label edText Area (String name, String label) { 
super (name) ,- 
this. label = label; 

} 

/ ** 

* ©param label the text label to use with this TextArea tag 
*/ 

public LabeledTextArea (String name,int rows , int cols,Strxng label] 
{ 

super (name, rows, cols) ; 
Q this. label = label; 

X R /** 

'-4 * ©param label the text label to use with thxs Input tag 

= C */ 

§".5 public void setLabel (String label) { 
;^ this. label = label; 

} 

public String getLabel ( ) { 
^ return label; 

i i \ 

1^ public String render () { 

jjL return label + super . render () ; 
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package com . thinairapps . tag ; 
/** 

* The Attribute class is used to store all name/value pairs within a Tag object. This * 

represents 

* a standard XML attribute 
*/ 

public class Attribute 

{ 

String name; 
String value; 
boolean useQuotes; 

private static final String NO_NAME = n _NONE"; 
/ * * 

* ©param name The attribute name 

* ©param value The attribute value 

* ©param useQuotes determines whether the value should be surrounded by quotation marks 
*/ 

public Attribute (String name, String value, boolean useQuotes) 

{ 

this. name = name; 
this. value = value ; 
this .useQuotes = useQuotes; 

} 

/ * * 

* ©param name The attribute name 

* ©param value The attribute value 
*/ 

public Attribute (String name, String value) 

{ 

this (name, value, true) ; 

} 

/** 

* ©param value A standalone value to be used within a tag. The name defaults to 

* 'JtfONE' . 
*/ 

public Attribute (String value) 

{ 

this (NO_NAME, value , false) ; 

} 

* ©return the attribute name 

*/ 

public String getName ( ) 
{ 

return name; 

} 

/ * * 

* ©return the attribute value 
*/ 

public String getValue ( ) { 
return value; 

} 

/** 

* ©return a string object representing the fully rendered text for this attribute 
*/ 

public String render ( ) 

if ( name. equal s (NO_NAME) ) { 
return value ,* 

} 

else { 
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if (useQuotes) 

return name + "=\"" + value + «\"« ; 

else 

return name + "=" + value; 



} 



} 
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package com . thinairapps . tag ; 

/** 

* This runtime expection is thrown when addChildO is called, and passed a tag which 

* the class doesn ( t support as a child tag 

*/ 

public class Inval idTag Except ion extends Runt imeExcept ion 

{ 

/ * * 

* ©param message text to display for this exception 
*/ 

public Inval idTagExcept ion (String message) 
{ 

super (message) ; 

} 

I -k * 

*/ 

public Inval idTagExcept ion ( ) 
{ 

super ( "invalid tag used"); 

} 
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package com. thinairapps . tag ; 

import java . util . Enumeration ; 
import java .util .Hashtable ; 
import java .util .Vector ,- 

/ * * 

* This class is the basic Tag class used to implement all 

* other Tag elements. It can be extended to implement a new markup 

* language. A Tag can have any number of Attributes, be standalone 

* or paired, and have a hierarchy of children Tags. 
*/ 

public class Tag 
{ 

public String name; 
public Hashtable attributes; 
public Vector children ; 
public boolean closingTag; 

/ * * 

* A constructor which creates a tag with the given name, and which may either be 

standalone or a pair. 

* "~ 

* ©param name the text to use for this tag (i.e. 'body' would be the value for <body&^ 
□ 9t;> 

^ * ©param closingTag indicates whether this tag has a paired closing tag or is standalone 

la? + J 

H public Tag (String name, boolean closingTag) 

4 i 

f~ this, name = name; 

-~ attributes = new Hashtable 0; 

& children = new Vector {) ,- 

si this . closingTag = closingTag; 

} 

I * * 

* A constructor which creates a paired tag set with the given name. 
* 

* ©param name the text to use for this tag (i.e. 'body' would be the value for <body&tf 
gt;> 

*/ 

public Tag (String name) 

{ 

this (name, true) ; 

} 

I * * 

* ©return name of this tag 
*/ 

public String getName ( ) 
{ 

return name; 

} 

/ * * 

* ©return Vector of all child tag of this tag. Note that the children themselves may be * 
parent nodes . 

*/ 

public Vector getChildren ( ) 

{ 

return children; 

} 

/ * * 

* ©return A Hashtable of all attributes for this tag 
*/ 

public Hashtable getAttributes ( ) 

{ 
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return attributes; 

} 

/** 

* ©return indicated whether this Tag has a closed pair or is open and standalone 
*/ 

public boolean isClosedTag ( ) 
{ 

return this . closingTag ; 

} 

/ * * 

* Sets the name of this tag, after it has been constructed. 
* 

* ©param name the text to use for this tag (i.e. 'body 1 would be the value for <body&*' 

gt ; > 

*/ 

public void setName (String name) 

{ 

this. name = name; 

} 

I *★ 

* Used to add an attribute object to this tag 
* 

=7 * ©param attrib The attribute object to add to this tag 
S */ 

*Z public void addAttribute (Attribute attrib) 

« { 

tj attributes .put (attrib. getName ( ) .attrib) ; 

f } 

*y / ** 

4 * Used to add an attribute, in the form of a name/value pair, to this tag 
* 

^ * ©param name the attribute name 

* ©param value the attribute value 
□ */ 

f\ public void addAttribute (String name, String value) 
* i 

z. addAttribute (new Attribute (name, value) ) ; 

2 } 

/** 

5=3 * Used to retrieve an existing attribute for this tag object 
* 

* ©param name the name of the attribute object to retrieve 

* ©return an attribute object corresponding to the name value passed; will be NULL if *r 

attribute doesn't exist 

*/ 

public Attribute getAttribute (String name) 

{ 

return (Attribute) attributes .get (name) ; 

} 

/ * * 

* Used to add a child tag to this tag object. Intended for use only 

* with paired or "closed" tags, but won't throw an exception either 

* way. Tag never throws an InvalidTagException, but classes which 

* extend Tag may to enforce restrictions of certain markup languages. 
★ 

* ©param child A Tag object to add as a child of this tag 
*/ 

public void addChild (Tag child) throws InvalidTagException 
{ 

children . addElement (child) ; 

} 

/ * * 
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* Clears all child tags from this tag. 
*/ 

public void clearChildren ( ) 

{ 

children. removeAll Elements { ) ; 

} 

/** 

* This method is currently not implemented. The goal of it is however to 

* allow a markup language text to be passed to it, and have a complete object 

* hierarchy be created- similar to an XML DOM Parser. 
*/ 

public void parse (String fullTagText) 

{ 
} 

/ * * 
* 

* This method is intended to be used as a way of creating a tag less version 

* of a tag hierarchy. For instance, you may create a complete HTML Tag hierarchy 

* of a webpage, either directly or through parsing, and then want just the text 

* content from that page for display on a WAP Phone or Pager. 

* " 

* ©return only "intra- tag" text content for itself, and all subtags . 
*/ 

public String getTextOnly ( ) 

{ 

Enumeration eChildren = children . elements () ; 

StringBuffer text = new StringBuf fer () ; 

while (eChildren . hasMoreElements ( ) ) 

text.append( ( (Tag) eChildren . nextElement ( ) ) . getTextOnly ( ) + " ") ; 

return text . toString ( ) ; 

} 

/** 

* Renders opening tag, if a paired set, or the only tag if otherwise. All 

* attributes are also rendered as part of this Tag. 
* 

* ©return formatted markup content of opening tag 
*/ 

protected String renderOpenTag ( ) 

{ 

StringBuffer output = new StringBuf fer () ; 

//render self open 
output . append ( " < " ) ; 
output . append ( name ) ,* 

Enumeration eAttribs = attributes . elements () ; 

while (eAttribs .hasMoreElements ( ) ) 

output .append ( " " + ( (Attribute) eAttribs . nextElement ()). render ()) ; 

output . append ( " >\n " ) ; 

return output . toString () ; 

} 

f * * 

* Loops through all children Tag objects and calls their render ( ) methods, 

* which, if parent tags themselves, would cause them to render () their children. 
* 

* ©return formatted markup text of all child Tags of this Tag 
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*/ 

protected String renderChildren ( ) 
{ 

StringBuffer output = new StringBuf fer () ; 

Enumeration eChildren = children . elements () ; 

while (eChildren. hasMoreElements ( ) ) 

output .append ( ( (Tag) eChildren . nextElement ( ) ) . render ( ) ) ,- 

return output . toString ( ) ; 

} 

* Renders closed tag, if paired set, otherwise returns empty String 
* 

* ©return formatted markup text of closing tag, or emtyp String if no closingTag 
*/ 

protected String renderCloseTag ( ) 

{ 

if (closingTag) 

return " </" + name + ">"; 

else 

return " " ; 

} 

I ** 

* Returns the markup String for this Tag and all of its children. 
* 

* ©returns formatted markup text of this tag, all attributes, and all child tags. 
*/ 

public String render () 

{ 

StringBuffer output = new StringBuf fer () ; 
output . append ( renderOpenTag ( ) ) ; 
output . append (renderChildren ( ) ) ; 
output . append (renderCloseTag ( ) ) ; 
return output . toString ( ) ; 

} 
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package com. thinairapps . tag ; 
/ * * 

* @ {#) TagDocument . java 

* This abstract class functions as the container for all tag-based documents. It is * 

extended by 

* classes like WMLTagDocument HDMLTagDocument , and HTMLTagDocument to implement the ^ 

specifics of 

* each document type . 

* <p> 

* In general, you will only want to use this class directly when implementing connectors ^ 

that render 

* more than one type of markup. This class gives you a means of having a reference to a 

TagDocument without 

* concerning yourself the type of browser to which the document is to be rendered. When ^ 

rendering for only one 

* browser, you can just use HTMLTagDocument, WMLTagDocument, etc. directly. 

* </p> 
*/ 

public abstract class TagDocument 

{ 

private String location; 

private Tag root ; 

private String contentType; 

private String doc Type ; 

^ / * ★ 

U * Primary constructor used to build a specific type of TagDocument hierarcy. 
U * 

~J * ©param rootTag the name of the root document tag. (i.e. "HTML" for a webpage, or v? 
£ "WML" for a WAP Deck) 

~ * ©param contentType the MIME content -type associated with the markup language being 
M generated. 

~J * ©param closed indicates whether the root tag is opened, or closed/paired. 
ft */ 

public TagDocument (String rootTag, String contentType, boolean closed) 

root = new Tag (rootTag, closed) ; 
t% this .contentType = contentType; 

3 } 

ft /* * 

"1 * Primary constructor used to build a specific type of TagDocument hierarcy. 
~T * Assumes that the root tag is a paired or closed. 

* ©param rootTag the name of the root document tag. (i.e. "HTML" for a webpage, or 

"WML" for a WAP Deck) 

* ©param contentType the MIME content -type associated with the markup language being 

generated. 

*/ 

public TagDocument (String rootTag, String contentType) 

{ 

this ( rootTag , contentType , true ) ; 

} 

* Sets the root node to a new Tag object. 
* 

* ©param root The Tag object to use as the root tag for this document. 
*/ 

public void setRoot (Tag root) 

{ 

this. root = root; 

} 

/ * * 

* Gets the root Tag object for this document. 
* 

* ©return The root Tag object for this document. 
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*/ 

public Tag getRoot ( ) 

{ 

return root ; 

} 

/* * 

* Adds a child Tag to the root Tag of this document . 
* 

* ©param child A Tag object to add as a child of the root Tag. 
*/ 

public void addChild (Tag child) throws InvalidTagException 

{ 

getRoot () .addChild (child) ; 

} 

J * * 

* Returns the entire rendered document text, suitable for display 

* in a browser which supports the MIME type specified by the document's 

* content- type . 
* 

* ©param formatted markup language as String 
*/ 

public String render ( ) 

{ 

3 return root . render ( ) ; 

o > 

* The Internet MIME content-type which this document supports. 
★ 

* ©return an official internet mime- type such as text/html, or text/vnd. wap . wml 
*/ 

public String getContentType ( ) 

a { 

return contentType ; 
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package com . thinairapps . tag . html ; 
import com. thinairapps . tag .* ; 
/** 

* Used to define intra or inter page hyperlinlcing action. 
*/ 

public class Anchor extends HTMLTag 

{ 

/ * * 

* ©param name anchor name (used for intra page linking) 
*/ 

public Anchor (String name) 

{ 

super ( "a" , true) ; 

if (name null && name . length ( ) > 0) 
addAt tribute ( "name" , name) ; 

} 

/** 

* 

* ©param name anchor name (used for intra page linking) 

* ©param child a child node to wrap within this tag 
*/ 

public Anchor (String name, HTMLTag child) 

3 ( 

P this (name) ; 

^ addChild (child) ; 

H } 

i /** 

~ * 

& * ©param name anchor name (used for intra page linking) 

y * ©param href the URL or #tagname which this anchor should link to 

B */ 

public Anchor (String name, String href) 

_ { 

^ this (name) ; 

Ti addAttribute ("href" , href ) ; 

3 } 

n / * * 
* 

"7 * ©param name anchor name (used for intra page linking) 

* ©param href the URL or #tagname which this anchor should link to 

* ©param child a child node to wrap within this tag 
*/ 

public Anchor (String name, String href, HTMLTag child) 

{ 

this (name, child) ,* 
addAttribute ( "href ", href ) ; 

} 

/* * 

* ©param name anchor name (used for intra page linking) 

* ©param href the URL or #tagname which this anchor should link to 

* ©param target the name of target window or frame which to target the hyperlink action 

to 

* ©param child a child node to wrap within this tag 
*/ 

public Anchor (String name, String href, String target , HTMLTag child) 
{ 

this (name, child) ; 
addAttribute ( "href href ) ; 
addAttribute ( " target " , target ) ; 

} 

/** 

* ©param action set a client-side scripting event 
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*/ 

public void setOnMouseOver (String action) 

{ 

addAt tribute ( "onMouseOver " , action) ; 

} 

I * * 

* ©param action set a client -side scripting event 
*/ 

public void setOnMouseOut (String action) { 
addAttribute { "onMouseOut" , action) ; 

} 

/ + * 

* ©param action set a client -side scripting event 
*/ 

public void setOnClick (String action) { 
addAttribute ( "onclick" , action) ; 

} 
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package com. thinairapps . tag .html ; 
import com. thinairapps . tag . * ; 
/** 

* The main content tag for an html page 

* @ ( # ) Body . j ava 
+ 

*/ 

public class Body extends HTMLTag 
{ 

Tag header; 
Tag footer; 

/** 

* Basic constructor 
*/ 

public BodyO 

{ 

super ( "body" , true) ; 

} 

I * * ^ 

* ©param bgColor hex or name value for page background color 

* ©param fgColor hex or name value for text font color 
M * ' ©par am linkColor hex or name value for link font color 

*/ 

Vj% public Body (String bgColor, String textColor, String linkColor) { 
V'\ thisO; 

2 addAttribute ( "bgColor" , bgColor) ; 

?P addAttribute ( " text " , textColor) ; 

IjJ addAttribute ("link" , linkColor) ; 

III addAttribute ("al ink" , linkColor) ; 

addAttribute ( "vlink" , linkColor) ; 

m } 

!iif / * * 

Ui * ©param background url to a background image file 

O * ©param bgColor hex or name value for page background color 

i^i * ©param fgColor hex or name value for text font color 

]— * ©param linkColor hex or name value for link font color 

P */ 

!=£ public Body (String background, String bgColor , String fgColor , String linkColor) { 
this (bgColor, fgColor, linkColor) ; 
addAttribute ( "background" , background) ; 

} 

/ ** 

* ©param p paragraph element to add as child 
*/ 

public void addParagraph (Paragraph p) { 
try { addChild(p) ; } 
catch (InvalidTagExcept ion e) {} 

} 



I * * 

* ©param action scripting action to perform when page is loaded 
*/ 

public void setOnLoad (String action) { 
addAttribute ( "onLoad" , action) ; 

} 

j * * 

* ©param header HTMLTag to display at the top of each page 
*/ 

public void setHeader (HTMLTag header) 

{ 
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this. header = header; 



/ * * 

* ©param footer HTMLTag to display at the bottom of each page 
*/ 

public void set Footer (HTMLTag footer) 
{ 

this. footer = footer; 

} 

public String render ( ) 
{ 

StringBuffer output = new StringBuf f er ( ) ; 

output . append { renderOpenTag ( ) ) ; 

if (header != null) 
output . append (header . render ( ) ) ; 

output . append (renderChildren ( ) ) ,- 

if (footer != null) 
output . append ( footer . render ( ) ) ; 

p output . append ( renderCloseTag ( ) ) ; 

^ return output . toString () ; 
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package com . thinairapps - tag . html ,- 
import com . thinairapps . tag . Tag ; 
I * * 

* A text formatting node that indicates the text that should be displayed in bold. 
*/ 

public class Bold extends HTMLTag 
{ 

I * * 

* Basic Constructor 
*/ 

public Bold 0 

{ 

super ("b") ; 

} 

/** 

* Oparam text content that should be displayed in BOLD 
*/ 

public Bold (String text) 

{ 

this () ; 

addChild(new Text (text) ) ; 



*Q /** 

sir: * ©param tag HTMLTag that should be added as default child to this tag 

S'l */ 
- public Bold < HTMLTag tag) 

,p { 

Sij thisO; 

I'Js addChild(tag) ; 
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package com . thinairapps . tag . html ; 



import com . thinairapps . tag . * ; 



/** 

* <br>- inserts a line break into the content 
*/ 

public class Break extends HTMLTag 
public Break () { 



super ( "br" , false) ; 



public String render () { 
return "<BR>"; 
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package com. thinairapps . tag . html ; 
/ * * 

* A form element that can be used to trigger actions 
*/ 

public class Button extends Input 

{ 

/** 

* ©param name the unique identifier for this button 
*/ 

public Button (String name) { 
super ( "button" , name) ; 

} 

/ * * 

* ©param name the unique identifier for this button 

* ©param value the displayed text on the button 
*/ 

public Button (String name, String value) 

{ 

super ( "button" , name , value) ,• 

} 

/ * * 

* ©param action scriptable action caused when button is clicked 
□ */ 

y public void setOnClick (String action) 
^ addAttribute ( "onclick" , action) ; 
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package com. thinairapps . tag . html ; 

import com . thinairapps . tag . * ; 
/* * 

* All children tags of this tag will be centered on the page 
*/ 

public class Center extends HTMLTag 

{ 

public Center () 

{ 

super ( "center" , true) ; 

} 

/ * * 

* Construct with a default child tag 
* 

* oparam child the default child tag to be centered 
*/ 

public Center (HTMLTag child) 

{ 

super ( "center" , true) ; 
addChild (child) ; 



O 



} 
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package com . thinairapps . tag . html ; 
import com. thinairapps . tag .* ; 
/★* 

* A form element indicating a boolean state 

*/ 

public class CheckBox extends Input 
{ 

public final static int LABEL_BEFORE = 0; 
public final static int LABEL_AFTER = 1; 

Tag label ; 

int orientation; 

I * * 

* ©param name the unique 

* ©param value the default value to submit (if checked is true) 

* ©param checked indicates state of checkbox 
*/ 

public CheckBox (String name, String value , boolean checked) 

{ 

super ( " checkbox" , name , value ) ; 
if (checked) 

□ addAttribute (new Attribute ( "checked" )) ; 

o ) 

T /** 

2 * ©param name the unique 

C * ©param value the default value to submit (if checked is true) 
\\ * ©param checked indicates state of checkbox 

= l * ©param label a tag class to use as a label for this element 

^ * ©param orientation a constant indicating position of label (LABEli_BEFORE | | LABEL_AFTER) 
S */ 

public CheckBox (String name, String value , boolean checked, HTMLTag label , int orientation) { 
ssi this (name, value, checked) ; 

if setLabel (label , orientation) ; 

Li } 

- : ; J * * 

□ * ©param label a tag class to use as a label for this element 

* ©param orientation a constant indicating position of label (LABEL_BEFORE | | LABEL_AFTER) 

*/ 

public void setLabel (Tag label, int orientation) 

{ 

this. label = label; 

this .orientation = orientation; 

} 

public String render ( ) { 

StringBuffer output = new StringBuf f er ( ) ; 

if (label != null && orientation == LABELj_BEFORE) 
output . append (label . render ( ) ) ; 

output . append ( super . render ( ) ) ,- 

if (label != null && orientation == LABE1j_AFTER ) 
output . append ( label . render ( ) ) ; 

return output . toString () ; 
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package com. thinairapps - tag . html ,- 
import com . thinairapps . tag . * ; 
I * * 

* Insert a hidden text comment into the page 
*/ 

public class Comment extends HTMLTag 

{ 

/ * * 

* ©param text message to put in comment 
*/ 

public Comment (String text) { 

super ("!-- + text + " -- " , false ) ; 

} 

} 
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package com . thinairapps . tag ♦ html ; 

/** 

* A link to a cascading stylesheet document- should be put in page header 
*/ 

public class CSSLink extends Link 
{ 

/ * * 

* ©param href url link to CSS document 
*/ 

public CSSLink (String href) 

{ 

super ("stylesheet", "text/ess", href); 

} 

} 
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package com - thinairapps . tag . html ,- 

import com. thinairapps . tag . InvalidTagException; 

/ ** 

* A basic widget for creating a body tag that displays some text. You must 

* call the Construcor and buildPageO for the tag hierarchy to be created. 
*/ 

public class DisplayBody extends Body 

{ 

public DisplayBody ( ) 

{ 

super ( ) ; 

} 

/ * * 

* ©param text message to be displayed 

* ©param align alignment (Paragraph . CENTER, etc.) to use on text 
*/ 

public void buildPage (String text, String align) 

{ 

Paragraph p = new Paragraph (align) ; 
_ p . addChild (new Text (text)); 

O addParagraph (p) ,- 

bp } 

" ™ / * * 

>h 4 * ©param text message to be displayed 

;C * ©param align alignment (Paragraph. CENTER, etc.) to use on text 

■ Is * ©param href url link to insert into page via confirmation button (i.e. "Ok") 

^ */ 

public void buildPage (String text, String align, String href) 

m { 

try { 

Paragraph p = new Paragraph (align) ; 
y p.addChild (new Text (text )) ,- 

\}1 addParagraph (p) ; 

13 addChild (new Break ()) ,- 

addChild (new Anchor ( " " , href , new Text ( "Ok" ) ) ) ; 

54, catch (InvalidTagExcept ion e) { 

e.printStackTraceO ; 

} 
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package com. thinairapps . tag . html ; 
import com. thinairapps . tag .* ; 
/** 

* A tag indicated text styling parameters 
*/ 

public class Font extends HTMLTag 

{ 

I + * 

* ©param face the font face to apply to all children text tags 
*/ 

public Font (String face) 
{ 

super ( "font " , true) ; 

addAt tribute ( "face" , face) ; 

} 

/ * * 

* ©param face the font face to apply to all children text tags (i.e. Arial , Helvetica) 

* ©param size the font size to apply to all children text tags 
*/ 

public Font (String face,int size) 

{ 

this (face) ; 
□ addAt tribute ("size" , "" + size); 

0 } 

M /** 

'*4 * ©param face the font face to apply to all children text tags (i.e. Arial, Helvetica) 

jc * ©param size the font size to apply to all children text tags 

s * ©param color a hex or named color value to apply to all children text tags 

* */ 

^ public Font (String face,int size, String color) 

9 { 

this (face, size) ; 

addAt tribute ("color" , "#" + color); 
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package com . thinairapps . tag . html ; 
import com. thinairapps . tag .* ; 
/** 

* A Form element for gathering user input and submitting it to an HTTP server 
*/ 

public class Form extends HTMLTag 

{ 

/ ★* 

* ©param name the unique form id 
*/ 

public Form (String name) 

{ 

super ( "form" , true) ; 

addAt tribute ( "name" , name) ; 

} 

I * * 

* ©param name the unique form id 

* ©param action the URL which to post the form data to 

* ©param method the HTTP method which to submit the data with (POST, GET, PUT) 
*/ 

public Form (String name, String action, String method) { 
l=J this (name) ; 

= fl addAt t r ibut e ( "action" , action) ; 

i : fi addAt tribute ( "method" , method) ; 

KX ) 

= == /* * 

*zl * @param elem add a FormElement subclass as a child to this form 

^ */ 

.J? public void addFormElement (FormElement elem) { 

W try { 

s addChild(elem) ,- 

i=i II if ( ! (elem instanceof Hiddenlnput ) ) 
// addChild(new BreakO); 

|3 catch (InvalidTagExcept ion e) {} 

12 > 
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package com . thinairapps . tag . html ; 
import com. thinairapps . tag . * ; 
/** 

* An element used as a base class for all form input elements 
*/ 

public class FormElement extends HTMLTag 

{ 

/ * * 

* ©param tagName the name of the form element tag ( "input "button" ) 

* ©param name the unique id of this element 

* ©param closedTag indicates if this tag is standalone or has a closing pair 
*/ 

public FormElement (String tagName , String name, boolean closedTag) 
{ 

super (tagName , closedTag) ; 
addAt tribute ( "name" , name) ; 

} 
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package com. thinairapps . tag . html ; 
import com . thinairapps . tag . * ; 
/** 

* Tag to create header section within an HTML page 
*/ 

public class Head extends HTML/Tag 

{ 

public HeadO { 

super ( "head" , true) ; 

} 

} 
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package com. thinairapps . tag . html ; 
/ * * 

* A Form element used for setting hidden variable values within a form 
*/ 

public class Hidden Input extends Input 

{ 

I * * 

* ©param name the unique id for this element 

* ©param value the value to send for this variable 
*/ 

public Hiddenlnput (String name , String value) 

{ 

super ( "hidden " , name , value ) ; 

} 

} 
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package com. thinairapps . tag .html ; 
import com . thinairapps . tag . * ; 
/** 

* Creates a horizontal line for seperating content on a page 
*/ 

public class HorizontalRule extends HTML/Tag 

public HorizontalRule ( ) { 
super ( "hr" , false) ; 

} 

/ * * 

* ©param width a pixel value for the width of this rule 

* ©param noShane indicates whether to have any shade or shadow on this rule 
*/ 

public HorizontalRule ( int width, boolean noShade) 
{ 

thisO ; 

addAt tribute (new Attribute ( "width" , " " + width, false) ) ; 

if (noShade) 

addAttribute (new Attribute ( "noShade" ) ) ; 

3 } 

0 / * * 

■fi * ©param width a percentage value for the width of this rule 

r ^ * ©param noShane indicates whether to have any shade or shadow on this rule 
2 */ 

L public HorizontalRule (String width, boolean noShade) { 
Ll thisO; 

/I addAttribute (new Attribute ( "width" , width, true) ) ; 

S if (noShade) 

addAttribute (new Attribute ( "noShade" ) ) ,- 
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package com. thinairapps . tag . html ; 

import com. thinairapps . tag . * ,- 

import java .util . Enumeration ; 

I * * 

* The super class for all HTML tag implement ions 
*/ 

public class HTMLTag extends Tag 

{ 

/ * * 

* A constructor which creates a tag with the given name, and which may either be * 

standalone or a pair. 

* ©param name the text to use for this tag (i.e. 'body' would be the value for <body&i^ 

gt ; ) 

* ©param closingTag indicates whether this tag has a paired closing tag or is standalone 
* 

*/ 

public HTMLTag (String name, boolean closingTag) { 
super (name , closingTag) ; 

} 

/** 

_ * A constructor which creates a tag set with the given name. 

□ * ©param name the text to use for this tag (i.e. 'body' would be the value for <body&tf 
0 - gt ; ) 

n */ 

*t public HTMLTag (String name) { 
super (name); 

P } 

protected String renderOpenTag ( ) { 

B StringBuffer output = new StringBuf f er ( ) ; 

a% //render self open 

•Jf output . append ( " < 11 ) ; 

I I output . append (get Name ( ) ) ; 

5L Enumeration eAttribs = getAttributes (). elements () ; 

sJ while (eAttribs . hasMoreElements ( ) ) 

^ output . append ( " " + ( (Attribute) eAttribs . nextElement ()). render ()) ; 

output - append ( 11 > " ) ; 
return output . toString ( ) ; 

} 

} 
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package com . thinairapps . tag . html ; 
import com . thinairapps . tag . * ; 
/* * 

* The basic "page" object, used for all html document rendering 
*/ 

public class HTMLTagDocument extends TagDocument 

{ 

private Head head; 
private Body body; 

public HTMLTagDocument ( ) { 

super ("html " , "text/html") ; 

} 

/** 

* ©param head set the header section for this page 
*/ 

public void setHead(Head head) { 
this. head = head; 
resetChildren ( ) ; 

} 

I * * 

O * ©param body set the main content body section for this page 
*0 */ 

jji public void setBody(Body body) { 

this, body = body; 
5 resetChildren () ; 

: h } 

i/J private void resetChildren ( ) { 
^jf getRoot (). clearChildren () ; 

try { 

Jjf if (head != null) 

U" getRoot ( ) . addChild (head) ; 

if (body != null) 
)t: getRoot ( ) . addChild (body) ; 

catch (InvalidTagExcept ion e) {} 

} 

} 
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package com . thinairapps . tag . html ; 

import com. thinairapps . tag . InvalidTagException,- 

/ *★ 

* Creates an anchor object with an img tag child 
*/ 

public class Hyperlinkedlmage extends Anchor 

{ 

/ * * 

* ©param href the url which to link to 

* ©param imgSrc the image url which to load 
*/ 

public Hyperlinkedlmage (String href, String imgSrc) 

{ 

super ( " " , href , new Image ( imgSrc ) ) ; 

} 

/ * * 

* ©param name a unique id to use for the anchor and image 

* ©param href the url which to link to 

* ©param imgSrc the image url which to load 
*/ 

public Hyperlinkedlmage (String name, String href, String imgSrc) 

,J { 

0 this (name, href) ; 

Image imgl = new Image ( imgSrc) ,- 
2 imgl . addAt tribute ( "name" ,name) ; 

h addChild(imgl) ; 

'u ) 

/★ * 

~~ ' 

r=? * ©param name a unique id to use for the anchor and image 

* ©param href the url which to link to 

s l * ©param imgSrc the image url which to load 

£ * ©param target the target window or frame which to send the hyperlink action to 
fj */ 

public Hyperlinkedlmage (String name, String href, String imgSrc, String target) 

n { 

this (name, href , imgSrc) ; 

=* addAttribute ( " target " , target ) ; 

} 

} 
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/** 

* @ (#) Image . java 
* 

* an element used to insert an image into a page 
*/ 

package com . thinairapps . tag . html ,* 

import com . thinairapps - tag . * ; 

import java .util .Enumeration; 

/♦♦Represents an <img> tag in HTML 
*/ 

public class Image extends HTMLTag 

{ 

/ * * 

* Creates the image tag 
* 

* ©param src the url to load the image file from 
*/ 

public Image (String src) { 
super (" img" , false) ; 

addAt tribute (new Attribute ( " src" , src) ) ; 
=J addAttribute (new Attribute ( "border" , "0 " , false) ) ,- 

s } 

I * * 

^ * ©param src the url to load the image file from 

E * ©param alt the text to display if device does not support image 

li */ 

1 public Image (String src, String alt) { 
^ this (src) ; 

U addAttribute (new Attribute ( "alt " , alt )) ; 

} 



I * * 

* ©param src the url to load the image file from 

* ©param alt the text to display if device does not support image 

* ©param width the pixel width of image 

* ©param height the pixel height of image 
*/ 

public Image (String src, String alt,int width, int height) { 
this (src, alt) ; 

addAttribute (new Attribute ( "width" , " 11 + width, false) ) ; 
addAttribute (new Attribute ( "height "," " + height , false) ) ; 

} 

/ * * 

* ©param return String returns only the ALT text for this element 
*/ 

public String getTextOnly ( ) { 

String imgText = getName ( ) ; 

Enumeration eAttributes = getAttributes (). elements () ; 
Attribute cAttrib; 

while (eAttributes . hasMoreElements ( ) ) { 

cAttrib = (Attribute) eAttributes . nextElement () ; 

if (cAttrib .getName (). equal slgnoreCase ( "alt " ) ) { 
imgText = cAttrib . getValue () ; 
break; 

} 
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} 

return 11 [" + imgText + "]" ; 
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package com.thinairapps.tag.html; 
/** 

* A basic form &lt ; input &gt ; element 
*/ 

public class Input extends FormElement 

{ 

I * * 

* ©param type the input type (button, submit, password, etc) 

* ©param name the unique id for this input 
*/ 

public Input (String type, String name) 
{ 

super ( "input " , name, false) ; 
addAttribute ( "type" , type) ; 

} 

I * * 

* ©param type the input type (button, submit, password, etc) 

* ©param name the unique id for this input 

* ©param value the default value 
*/ 

public Input (String type, String name, String value) { 
this (type, name) ; 

addAttribute ( "value" , value) ; 

- } 
p /** 

~~ * ©param value set the default value for this input 

fi */ 

""4 public void setValue (String value) { 

p addAttribute ( "value" , value) ,- 
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package com . thinairapps . tag . html ; 

/** 

* A form text -type &lt ; input&gt ; element with a text label 
*/ 

public class Labeledlnput extends Input 

{ 

String label ; 
I * + 

* Oparam name the unique id of this input 

* ©param label the text label to display 
*/ 

public Labeledlnput (String name .String label) { 
supe r("t ext " , name ) ; 
this. label = label; 

} 

I * * 

* ©param name the unique id for this input 

* ©param type the input type (button, submit, password, etc) 

* ©param value the default value 

* ©param label the text label to display 
*/ 

public Labeledlnput (String name, String type, String value, String label) { 
3 super (type, name, value) ; 

O this. label = label; 

5 } 

%x I * * 

E * ©param the text label to use for this input 

Li * / 

\\ public void setLabel (String label) { 
this, label = label; 

s } 

==. public String getLabelO { 
^ return label; 

n } 

~ public String render ( ) { 

* l return label + new NonBreakingSpace ( 1 ). render ( ) + super . render () ; 

3 } 
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package com. thinairapps . tag . html ; 

* A tag to use for linking in style- =jie-ets and other content 
*/ 

public class Link extends HTMLTag 

{ 

I * * 
* 

* ©param rel indicate the relat icc. = rLip from this document to the target 

* ©param type specify the MIME eyre for the linked document 

* ©param href specify the hyperrej* reference URL of the target document 
*/ 

public Link (String rel, Strino rvr. e , String href) 

{ 

super ("link", false); 
addAttribute ( "rel " , rel ) ; 
addAttribute ("type", type) ; 
addAttribute ( "href M , href ) ; 

} 



in 
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package corn, thinairapps . tag . html ; 
/* * 

* A tag to be used in header sections to indicate some metadata about the content 
*/ 

public class Meta extends HTMLTag 
{ 

public final static String PRO PERT Y_NAME = "name"; 

public final static String PROPERTY_HTTP_EQUIV = "ht tp-equiv" ; 

public final static String PRO PERT Y_USER_AGENT = "user-agent"; 

f * * 

* ©param propertyType the name in the content name/value pair 

* ©param propertyValue the value in the content name/value pair 

* ©param content the value for the "content" attribute 
*/ 

public Meta (String propertyType , String propertyValue , String content) 
{ 

super ( "meta" , false) ; 

addAttribute (propertyType , propertyValue) ; 
addAttribute ( "content" , content) ; 

} 

} 
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package com . thinairapps . tag . html ; 
/** 

* Inserts a blank space into a page 
*/ 

public class NonBreakingSpace extends Text 

{ 

/ * * 

* ©param number the number of spaces to insert 
*/ 

public NonBreakingSpace ( int number) { 
super ( " " ) ; 



} 



for (int i = 0; i < number; i + +) 

set Name (get Name ( ) + " &nbsp ; 11 ) ; 
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package com . thinairapps . tag . html ; 

import com. thinairapps . tag . InvalidTagException; 
import com. thinairapps . tag .Attribute ; 

/ * * 

* An &lt ;option&gt ; element to be added to a &lt ; Select &gt ; parent tag 
*/ 

public class Option extends HTMLTag 

public Option () { 

super ( "option" ) ; 

} 

I * * 

* ©param value return the specified value to the form-processing application instead of * 

the option contents 

* ©param label provide a label for this option 

public Option (String value, String label) { 
this( ) ; 

addAttribute ( "value" , value) ,- 
setLabel (label) ; 

} 

!ZJ / * * 

?D * ©param label set the label 

* / 

111 ' 

2f public void setLabel (String label) { 

try { addChild(new Text (label )) ; } 
I -A catch (InvalidTagException e) { } 

q } 

111 /** 

* ©param child HTMLTag 

h */ 

public void addChi Id (HTMLTag child) throws InvalidTagException { 
W" if (child instanceof Text) 

13 super .addChild (child) ; 

iF; else 

:tS throw new InvalidTagException ( "Option only supports Text or OnEvent children 

P tags"); 
\* } 

/ * * 

* ©param selected boolean value for making this item intially selected 
*/ 

public void setSelected (boolean selected) { 
if (selected) 

addAt tribute (new Attribute (" selected" ) ) ; 

} 
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package com. thinairapps . tag . html ; 

import com. thinairapps . tag . InvalidTagException; 

/** 

* An element used to seperate content section out within a page 
*/ 

public class Paragraph extends HTMLTag 

^ public final static String ALIGN_LEFT = "left"; 

public final static String AIjIGN_CENTER = "center"; 
public final static String AL I GN_R I GHT = "right"; 

public final static String AIiIGN_ JUSTIFY = "justify" ; 

public Paragraph () { 
super ("p") ; 

} 

public Paragraph (String align) { 
thisO ; 

addAttribute ( "align" , align) ; 



public void addChi Id (HTMLTag tag) { 
try { super .addChild( tag) ; } 
catch (InvalidTagException e) { 
e . printStackTrace ( ) ; 

} 

} 
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package com. thinairapps . tag - html ; 
/** 

* A text form input with an * mask for security 
*/ 

public class PasswordField extends Input 
{ 

/** 

* ©param name specify the name of the parameter to be passed to the form-processing 

applicaiton for this input element 

* ©param value specify the initial value for this element 

* ©param length specify the maximum number of characters to accept for this element 
* / 

public PasswordField (String name, String value, int length) { 
super ( "password" , name , value) ; 
addAttribute ( " size" , " " + length); 

} 

/* * 

* ©param name specify the name of the parameter to be passed to the form-processing 

applicaiton for this input element 

* ©param length specify the maximum number of characters to accept for this element 
*/ 

public PasswordField (String name, int length) { 

super ( "password" , name) ; 

O addAttribute ("size" , "" + length); 

*0 } 

JO /** 

* ©param name specify the name of the parameter to be passed to the form-processing 
-IE applicaiton for this input element 

Id */ 

public PasswordField (String name) { 
^ super ( "password" , name) ; 
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package com. thinairapps . tag . html ; 
import com. thinairapps . tag . * ; 
/ * * 

* Seperates out text that has been preformatted 
*/ 

public class Pre extends HTML/Tag 

{ 

public Pre() { 

super ( "pre" , true) ,- 

} 

} 
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package com . thinairapps . tag . html ; 
/* * 

* A form element used to reset the form content to its default state 
*/ 

public class ResetButton extends Input 

{ 

/ * * 

* ©param value specify an alternate label for the reset button 
*/ 

public ResetButton (String value) 

{ 

super ( "reset 11 , " " , value) ; 

} 

/★* 

* ©param action action taken onclick 
*/ 

public void setOnClick (String action) { 
addAttribute ( "onclick" , action) ; 

} 

} 
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package com . thinairapps . tag . html ; 
import com . thinairapps . tag . * ; 
I * * 

* Used to set of scripting code from the page content 
*/ 

public class Script extends HTMLTag 
{ 

/ * * 

* ©param language the scripting language the code is written in 
*/ 

public Script (String language) { 
super ( " script " , true ) ; 

addAt tribute (new Attribute ( "language" , language) ) ; 

} 

/** 

* ©param code the scripting code to insert into the page 
*/ 

public void setCode (String code) { 
addChildtnew Text (code) ) ; 

} 
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package com . thinairapps . tag . html ; 
import com . thinairapps . tag . * ,- 
/* * 

* A form input used to create a list or combo-box 
*/ 

public class Select extends FormElement 

{ 

I * * 

* ©param name unique id of this element 
*/ 

public Select (String name) { 

super ( " select " , name , true ) ; 

} 

/ ** 

* ©param text the displayed text for this entry 

* ©param selected indicates if this entry should be selected 
*/ 

public void addOpt ion (String text, boolean selected) 

{ 

Tag option = new Tag ( "option" ) ; 
if (selected) 

option. addAttribute (new Attribute (" selected" )) ; 

O 

iQ option. addChild (new Text (text) ) ; 

s 5 addChild (option) ; 

M } 

e ! .s * ©param option an Option HTMLTag to add to this select list 

;1 */ 

~~2 public void addOpt ion (Option option) { 

jlj try { addChild (option) ; } 

catch (InvalidTagExcept ion e) {} 

a } 

o /** 

i s * ©param value the submitted value for a new option entry 

^ s * ©param label the display value for a new option entry 

O */ 

|4, public void addOpt ion (String value, String label) { 
Option option = new Option (value , label ) ; 
addOpt ion (option) ; 

} 

/** 

* ©param options a set of option entries to add to this select list 
*/ 

public void setOptions (String [] options) { 
for(int i = 0; i < opt ions - length ; i+ + ) 

addOpt ion (new Option (options [i] , options [i] ) ) ; 

} 
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package com. thinairapps . tag .html ; 

import com. thinairapps . tag . InvalidTagExcept ion; 

/** 

* A widget used to create a Body with a form with a select tag and a submxt button 
*/ 

public class SelectlnputBody extends Body 
{ 

public SelectlnputBody ( ) { 
super () ; 

} 

/** 

* ©param bgColor set the background color of the document 

* ©param fgColor set the color of regular text in the document 

* ©param linkColor set the color of hypertext links in the document 

*/ 

public SelectlnputBody (String bgColor , String fgColor , String IxnkColor) { 
super ( ) ; 

addAttribute ( "bgColor" , bgColor) ; 
addAt tribute ( "text " , fgColor) ; 
addAttribute ( "link" , linkColor) ; 
addAttribute ( "alink" , linkColor) ; 
Id addAttribute ( "vlink" , linkColor) ; 

0 } 

~. / * * 

y * ©param background specify the URL of an image to be tiled in the document background 

P * ©param bgColor set the background color of the document 

•A * ©param fgColor set the color of regular text in the document 

* ©param linkColor set the color of hypertext links in the document 

1 */ 

U public SelectlnputBody (String background, String bgColor , String fgColor , String 

linkColor) { 
~. super ( bgColor , fgColor , 1 inkColor ) ; 

S addAttribute ( "background" , background) ; 

~ } 

™ / ** 

lJ * ©param href the url to submit the form to 

=J * ©param label the label to use for the select element 

=f= * ©param name the unique id of the select element 

* ©param optionValues the array of name/value pairs to use for the option elements 

* ©param align the Paragraph alignment value to use for the content 
*/ 

public void buildPage (String href,String label, String name , String [] [] opt ionVal s , String 
align) throws InvalidTagExcept ion { 

OptionU options = new Option [opt ionVals . length] ; 

for (int i = 0; i < opt ionVal s . length; i++) 

options[i] = new Option (opt ionVals [i] [1] , opt ionVals [i] [0] ) ; 

buildPage (href , label , name, options , align) ; 



f * * 

* ©param href the url to submit the form to 

* ©param label the label to use for the select element 

* ©param name the unique id of the select element 

* ©param options the array of Option tags to add to the select list 

* ©param align the Paragraph alignment value to use for the content 
*/ 

public void buildPage (String href, String label, String name , Option [] options , String «r 
align) throws InvalidTagExcept ion { 



Paragraph p = new Paragraph (align) 
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p. addChild (new Text { label )) ; 
p. addChild (new Break ()) ; 

Form form = new Form ( " forml " , href , "GET" ) ; 

Select select = new Select (name) ; 
Option cOpt = null; 

for (int i = 0; i < options . length; 
select . addOpt ion (options [i] ) ; 



form. addChild (select) ; 

form. addChild (new SubmitBut ton ( "Submit " ) ) ; 
p. addChild ( form) ; 
addChild (p) ; 
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package com . thinairapps . tag . html ; 

import com. thinairapps .tag - InvalidTagException; 

I * * 

* A widget used to create a Body with a form with a text input and a submit button 
*/ 

public class Single I nputBody extends Body 
{ 

public SinglelnputBody 0 

{ 

super () ,• 

} 

/ * * 

* Oparam href url to submit form to 

* ©param label text label for input tag 

* ©param name unique id for this form input 

* ©param buttonLabel label for submit button 
*/ 

public void buildPage (String href, String label, String name, String buttonLabel) 

{ 

_ Paragraph p = new Paragraph ( ) ; 

□ Form form = new Form (" forml href , "GET" ) ; 

p Labeledlnput input = new Labeledlnput (name , " text " , " " , label ) ; 

ft form . addFormElement ( input ) ; 

^ form. addFormElement (new SubmitButton (buttonLabel )) ; 

H p.addChild(form) ; 

C addParagraph (p) ; 
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package com.thinairapps.tag.html; 

import com - thinairapps . tag - InvalidTag Except ion ; 

/** 

* A widget used to create a Body tag with a form with a text input and a submit button 
V 

public class SinglelnputPage extends Body 
{ 

public SinglelnputPage ( ) { 
super ( ) ; 

} 



I * * 

* ©param href url to submit form to 

* ©param label text label for input tag 

* ©param name unique id for this form input 

* @param buttonLabel label for submit button 

*/ 

public void buildPage (String href, String label, String name, String buttonLabel) { 

Paragraph p = new Paragraph ( ) ; 

Form form = new Form ( " forml «, href , "GET" ) ; 
Label edlnput input = new Labeledlnput (name ," text label ) ; 
form . addF.ormElement (input) ; 

f orm.addFormElement (new SubmitButton (buttonLabel ) ) ; 
p.addChild (f orm) 
addParagraph (p) ; 
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package com . thinairapps . tag . html ,* 



* A form element used to trigger the submit action 
*/ 

public class SubmitButton extends Input 

.{ 

/ * * 

* ©param value the display text on the button 
*/ 

public SubmitButton (String value) { 
super { n submit " , "submit " , value) ; 

} 

public SubmitButton (String value, String name) { 
super ( "submit " , name, value); 

} 

/** 

* ©param action the scripting action to trigger when the button is clicked 
*/ 

public void setOnClick (String action) { 
addAttribute ( "onclick" , action) ; 

} 
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package com.thinairapps.tag.html; 

import com. thinairapps . tag . * ; 
/* * 

* A &lt ; table@gt ; HTML element to display tabular structured content 
*/ 

public class Table extends HTMLTag 

{ 

/ * ★ 

* Oparatn border an int value indicated the thickness of the table border 
*/ 

public Table (int border) 

{ 

super ( "table" , true) ; 

addAttribute (new Attribute { "border" ," " + border , false) ) ; 

} 

I ★* 

* ©param border an int value indicated the thickness of the table border 

* ©param cellpadding an int value indicated space padding within each table cell 

* ©param cellspacing an int value indicated spacing between each table cell 
*/ 

public Table (int border, int cellpadding , int cellspacing) { 
_ this (border) ; 

fZI addAttribute (new Attribute ( "cellpadding" ," " + cellpadding, false) ) ; 

k Q addAttribute (new Attribute { "cellspacing" , " " + cellspacing, false) ) ; 

" ~i / ** 

: £ * ©param border an int value indicated the thickness of the table border 
\\\ * ©param cellpadding an int value indicated space padding within each table cell 
V*. * ©param cellspacing an int value indicated spacing between each table cell 
^ * ©param width sets the width of the table in pixels 
IB * ©param height sets the height of the table in pixels 

; */ 

■==. public Table (int border, int cellpadding , int cellspacing, int width, int height) { 

^ this (border, cellpadding, cellspacing) ; 

lf\ addAttribute (new Attribute ("width" , MM + width, false) ) ; 

i 5 ^ addAttribute (new Attribute ( "height "," " + height , false) ) ; 

^0 /** o 

r c J * ©param border an int value indicated the thickness of the table border 

ie& * ©param cellpadding an int value indicated space padding within each table cell 

* ©param cellspacing an int value indicated spacing between each table cell 

* ©param width sets the width of the table in percentage 

* ©param height sets the height of the table in percentage 
*/ 

public Table (int border, int cellpadding, int cellspacing, String width, String height) { 
this (border, cellpadding , cellspacing) ; 
addAttribute (new Attribute ( "width" , width) ) ; 
addAttribute (new Attribute { "height ", height ) ) ,- 

} 
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package com . thinairapps . tag . html ; 
I * * 

* <td> - an individual cell for a table 
*/ 

public class TableCell extends TableElement 
{ 

public TableCell () { 
super ( " td" ) ; 

} 

/ * * 

* ©param width pixel width of cell 

* ©param height pixel height of cell 
* 

*/ 

public TableCell {int width, int height) { 
super ( "td" , width, height ) ; 

} 

/* * 

* ©param width pixel width of cell 

* ©param height pixel height of cell 

* ©param bgColor hex or named color for background of cell 
*/ 

□ public TableCell < int width, int height , String bgColor) { 
?% super ( "td" , width, height , bgColor) ; 
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package com . thinairapps . tag . html ,- 
import com. thinairapps . tag .* ; 
I * * 

* A super class for all table cells, headers rows, etc 
*/ 

public class TableElement extends HTMLTag 
{ 

/ * * 

* ©param tag name of Table 
*/ 

public TableElement (String tag) { 
super (tag, true) ; 

} 

I * * 

* ©param tag name of Table 

* ©param width width of Table 

* ©param height height of Table 
*/ 

public TableElement (String tag,int width, int height) { 
this (tag) ; 

addAttribute (new Attribute ( "width" , " " + width, false) ) ; 
„ addAttribute (new Attribute ( "height" , " " + height , false) ) ,- 

1 } 

~ / * * 

^ * ©param tag name of Table 

H * ©param width width of Table 

p * ©param height height of Table 

\i * ©param bgColor define the background color for the entire Table 

:'1 */ 

j? public TableElement (String tag, int width, int height , String bgColor) { 
U this (tag, width, height) ; 

addAttribute ( "bgColor" , bgColor) ; 

□ } 
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package com. thinairapps . tag - html ; 

/** 

* A table cell to use in the header row 
*/ 

public class TableHeader extends TableElement 

public TableHeader ( ) { 
super ("th" ) ; 

} 

I * + 

* ©param width set the width of the cell to X pixels or a percentage of the table width 

* ©param height define the height, in pixels, for this cell 
*/ 

public TableHeader (int width, int height) { 
superC'th" , width, height ) ; 

} 



/ * * 

* ©param width set the width of the cell to X pixels or a percentage of the table width 

* ©param height define the height, in pixels, for this cell 

* ©param bgColor define the background color for the cell 

*/ 

O public TableHeader ( int width, int height, String bgColor) { 
_fi super ( 11 th" , width, height , bgColor) ,- 

•s } 
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package com . thinairapps . tag . html ; 

/** 

* <tr>- the element to use for each row of the table 
*/ 

public class TableRow extends TableElement 

public TableRow () { 
super ("tr" ) ,- 

} 

public TableRow (int width, int height) { 
super ("tr", width, height) ; 

} 

public TableRow (int width, int height, String bgColor) { 
super ( "tr" , width, height , bgColor) ; 

} 
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package com . thinairapps . tag . html ; 
import com. thinairapps . tag .* ,- 
/** 

* A node used to wrap any text content for a page 
*/ 

public class Text extends HTMLTag 
{ 

public Text (String text) { 
super (text , false) ; 

} 

public String getTextOnly ( ) { 
return getName ( ) ; 

} 

public String render ( ) { 
return getName ( ) ,- 

} 

} 



•-P 
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package com . thinairapps . tag . html ; 
import com . thinairapps . tag . * ; 
/** 

* A multiline, scrollable text area input form element 
*/ 

public class TextArea extends FormElement 

{ 

/ * * 

* ©param name the unique id of this element 

* ©param rows the number of rows 

* ©param cols the number of columns 
*/ 

public TextArea (String name,int rows,int cols) { 
super { "text area" , name, true) ; 

addAt tribute ( "rows" , " " + rows) ; 
addAttribute ( "cols" , " " + cols) ; 

} 

/ * * 

* ©param text set the text value for this element 
*/ 

public void setValue (String text) { 

getChildren ( ) . removeAHElements ( ) ; 
getChildren (). addElement (new Text(text)); 

m 1 



* 
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package com. thinairapps . tag . html ; 

/** 

* A single text input form element 
*/ 

public class TextField extends Input 

{ 

/ * * 

* ©param name specify the name of the parameter that is passed to the form-processing 

application for this input element 

* ©param value specify the intial value for this element 

* ©param length specify the maximum number of characters to accept for this element 
*/ 

public TextField (String name, String value, int length) { 
super ( " text " , name , value ) ; 
addAttribute ( "size" , " " + length) ,- 

} 

/* * 

* ©param name specify the name of the parameter that is passed to the form-processing ^ 

application for this input element 

* ©param length specify the maximum number of characters to accept for this element 

*/ 

public TextField (String name, int length) { 
s Hi super ( "text name) ; 

addAttribute ( "size" , " 11 + length); 

m } 

: cj / * * 

* ©param name specify the name of the parameter that is passed to the form- processing 
application for this input element 

^ */ 

'"--4 public TextField (String name) { 
\'f% super ( "text name) ; 

U } 
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package com . thinairapps . tag . html ; 

import com. thinairapps . tag .* ; 
/** 

* A utility wrapper class for applying styles to text content 
*/ 

public class TextStyle extends HTMLTag 

{ 



public 


final 


static 


int 


PLAIN = 0; 


public 


final 


static 


int 


BOLD = 1; 


public 


final 


static 


int 


ITALIC = 2; 


public 


final 


static 


int 


UNDERLINE = 


public 


final 


static 


int 


TT = 4; 


public 


final 


static 


int 


HI = 5; 


public 


final 


static 


int 


H2 = 6; 


public 


final 


static 


int 


H3 = 7; 


public 


final 


static 


int 


H4 = 8; 


public 


final 


static 


int 


H5 = 9; 


public 


final 


static 


int 


H6 = 10; 



int style = PLAIN; 

public TextStyle (int style) { 
=3 super ( " " , true) ; 

this. style = style; 

!« > 

/** 

P * ©param style the style CONSTANT to apply 
F P * ©param child the html tag to wrap the style around 

m */ 

'''•-J public TextStyle (int style , HTMLTag child) { 

ifs super ( " " , true) ; 

~ this. style = style; 

addChild (child) ; 

■~ protected String renderOpenTag ( ) { 



if (style == BOLD) 




return " <b>"; 




else if (style ~~ 


ITALIC) 


return " <i>" ; 




else if (style == 


UNDERLINE) 


return 11 <u>" ; 




else if (style == 


TT) 


return "<tt>"; 




else if (style == 


HI) 


return "<hl> M ; 




else if (style == 


H2) 


return n <h2>"; 




else if (style 


H3) 


return " <h3>" ; 




else if (style == 


H4) 


return "<h4>"; 




else if (style == 


H5) 


return ,, <h5>"; 




else if (style 


H6) 


return n <h6>"; 




else 




return " " ; 





} 

protected String renderCloseTag ( ) { 
if (style == BOLD) 

return "</b>"; 
else if (style == ITALIC) 

return "</i> M ; 
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else if (style = = 


UNDERLINE) 


return n </u>" 




else if (style == 


TT) 


return n </tt> 


it . 


else if (style ~- 


HI) 


return "</hl> 


II . 
/ 


else if (style == 


H2) 


return "</h2> 


it . 


else if (style = = 


H3) 


return M </h3> 


tt . 


else if (style == 


H4) 


return " </h4> 


ti . 


else if (style 


H5) 


return "</h5> 


it . 


else if (style = = 


H6) 


return "</h6> 




else 




return 11 " ; 





# 
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package com . thinairapps . tag . html ; 
import com. thinairapps . tag .* ; 
I * * 

* A <title> tag to use in the header area of a page 
*/ 

public class Title extends HTMLTag 

{ 

/ * * 

* ©param title specify the title of the HTML doc 
* / 

public Title (String title) throws InvalidTag Except ion { 
super ( "title" , true) ; 
addChildCnew Text (title) ) ; 

} 

} 




# 
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1 



package com . thinairapps . tag . html . pqa ; 

import com. thinairapps . tag .* ; 
import com . thinairapps . tag . html . * ; 

/* * 

* A Palm anchor with the BUTTON attribute, indicated it should 

* be rendered as a button 



* 



* ©param text the Text for the button 

* ©param url the URL that is associated with the button 
*/ 




addAttribute (new Attribute ( "BUTTON" ) ) ; 



} 



"2 



C:\tas source\ThinAirServer\ . . \tag\html\pqa\DatePic)cer . java 



package com . thinairapps . tag . html . pqa ; 
import com . thinairapps . tag . html . * ; 
/ * * 

* A Palm form element that shows a calendar view 
* 

*/ 

public class DatePicker extends Input 
{ 

/** 

* ©param name Name for DatePicker 
*/ 

public DatePicker (String name) 
{ 

super < "datepicker" , name) ,- 

} 

} 
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package com . thinairapps . tag . html . pqa ; 
import com . thinairapps . tag . html . Meta ; 
/** 

* a palm header entry for controlling the displayed text in the HISTORY cache 
* 

*/ 

public class HistoryListMeta extends Meta 
{ 

/ ★ * 

* ©param text text for HistoryListMeta tag 
*/ 

public HistoryListMeta (String text) 

{ 

super ( "name" , "historylisttext " , text ) ,- 

} 

} 
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package com . thinairapps . tag . html . pqa ; 

/** 

* Some constants to use in url building. See Palm's PQA documentation for more information. 
*/ 

public class PalmConstants 

^ /**This get the unique device ID for the device making the request. 
*/ 

public final static String DEVICE_ID = "%deviceid"; 
/**This get the ZIP code for the nearest radio tower. 
*/ 

public final static String ZIP_CODE = "%zipcode" ; 

} 



# * 
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package com. thinairapps . tag .html .pqa; 
import com . thinairapps . tag . html .Meta ; 
/** 

* The meta tag to insert into a header to indicate the page should not 

* be "scraped" or "clipped" by the proxy, since it is already palm friendly 

*/ 

public class PalmContentMeta extends Meta 
public PalmContentMeta () 

{ 

super ( "name" , "PalmComputingPlatf orm" , "true") ; 

} 

} 
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package com . thinairapps . tag . html . pqa ; 
import com. thinairapps . tag . html . * ,- 
/** 

* A form element that display a time widget in a Palm PQA 
*/ 

public class TimePicker extends Input 

{ 

/ * + 

* ©param name specify the name of the element 
*/ 

public TimePicker (String name) 

{ 

super ( "timepicker" , name); 

} 

} 
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package com . thina i rapps . tag . hdml ; 
import com . thinairapps . tag . * ; 
/** 

* Represents an ACTION tag. 

* binds a label, an optional image/ and a ActionTask to the user's agent's navigational usertf 

interface 

* when the action is selected the indicated ActionTask takes place 
#/ 

public class Action extends HDMLTag { 

/** defines the acceptable action types */ 
public static class Type { 
private String name; 

private Type (String n) { name = n; } 
} // end Type 



public 


static 


final 


Type 


SOFT1 




new 


Type { 


"SOFT1") ; 


public 


static 


final 


Type 


S0FT2 




new 


Type{ 


"SOFT2" ) ; 


public 


static 


final 


Type 


S0FT3 




new 


Type ( 


n SOFT3") ; 


public 


static 


final 


Type 


SOFT4 




new 


Type ( 


"SOFT4 ") ; 


public 


static 


final 


Type 


SOFT5 




new 


Type ( 


"SOFT5 " ) ; 


_ public 


static 


final 


Type 


SOFT6 




new 


Type ( 


"SOFT6" ) ; 


«3 public 


static 


final 


Type 


SOFT7 




new 


Type ( 


"SOFT7 " ) ; 


p public 


static 


final 


Type 


S0FT8 




new 


Type ( 


" SOFT8 " ) ; 


■f\ public 


static 


final 


Type 


ACCEPT 




new 


Type ( 


"ACCEPT") 


"\ public 


static 


final 


Type 


PREV 




new 


Type ( 


"PREV") ; 


public 


static 


final 


Type 


HELP 




new 


Type ( 


"HELP" ) ; 



private Type type; 
private ActionTask task; 



* create a new HDML action 

* ©param type one of Type instances above 

* ©param task specifies the way in which the action is carried out (i.e. invoke 

subprocedure ) 

*/ 

public Action (Type type, ActionTask task) { 
this (type) ; 



addAttribute( new Attribute ( "TASK" , task . render () , false) ); 
this. task = task; 



* create an action with no Task useful for Choice lists 

* ©param type one of Type instances above 
*/ 

public Action (Type type) { 
super ( "ACTION" , false) ; 

addAttribute ( new Attribute ( "TYPE" , type. name, false) ); 
this. type = type; 

} 



/ * * 

* create a new HDML action with a destination, a label 

* and no ActionTask 

* ©param type one of Type instances above 

* ©param label String name to map to button invoking this action 

* ©param dest String URL destination to go to when Action is executed 

* / 

public Action (Type type, String label, String dest) { 
this (type) ; 
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setLabel (label) ; 

ActionTask task = new ActionTask (ActionTask . GOSUB) ; 
task . setDest (dest ) ; 

addAttribute{ new Attribute { "TASK", task . render () , false) ) ; 
this. task = task; 

} 



/ * * 

* create a new HDML action with a label 

* Oparam type one of Type instances above 

* ©param task specifies the way in which the action is carried out (i.e. invoke 

subprocedure ) 

* ©param dest String URL destination to go to when Action is executed 
*/ 

public Action (Type type, ActionTask task, String label) { 
this(type, task) ; 
setLabel (label) ; 

} 



/ * * 

* create a new HDML action with a label and an image 

* ©param type one of Type instances above 

=j * ©param task specifies the way in which the action is carried out (i.e. invoke 
% subprocedure ) 

™ * ©param label String name to map to button invoking this action 

£J * ©param image image tag to render Action (if supported by phone) 

4 */ 

~ public Action (Type type, ActionTask task, String label, ImageTag image) { 

^ this(type, task); 

U setLabel ( label ) ; 

%l set Image ( image) ; 



/* * 

* set the label option 

* the text to display for this action - try to keep to <= 6 characters 

* ©param label String to map to button executing Action 
*/ 

public void setLabel (String label) { 

addAttribute ( new Attribute ( "LABEL" , label) ); 

} 



* set the url of the image to display for this action 

* ©param image image tag to render Action (if supported by phone) 
*/ 

public void set Image ( ImageTag image) { 

addAttribute ( new Attribute (" IMAGE" , image . getSrc () ) ); 

} 

/ ** 

* ©return Type the type for this action 
*/ 

public Type getTypeO { return type; } 
/ ** 

* ©return ActionTask the ActionTask for this action 
*/ 

public ActionTask get Act ionTask ( ) { return task; } 



} // end 
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package com . thinairapps . tag . hdml ; 

import com . thinairapps . tag . * ; 
import java.util . * ; 

/ ** 

* Represents a ActionTask bound to a ChoiceEntry within a Choice card. 

* <p> 

* Different ActionTask types have different options -- see the HDML spec 

* for a complete account of which options are relevant for which ActionTask types 

* ; 

public class ActionTask extends HDMLTag { 

/** This inner class defines the acceptable types for Action Tasks */ 
public static class Type { 
private String name; 

private Type (String n) { name = n; } 
public String toString (){ return name;} 
} // end Type 

public static final Type GO = new Type ( "GO" ) ; 

public static final Type GOSUB = new Type ( " GOSUB " ) ; 

public static final Type PREV = new Type (" PREV ") ; 

public static final Type RETURN = new Type ( "RETURN" ) ; 
_ public static final Type CANCEL = new Type ( "CANCEL" ) ; 
□ public static final Type POST = new Type ( "POST" ) ; 

0 public static final Type CALL = new Type (" CALL " ) ; 
U public static final Type NOOP = new Type ( "NOOP" ) ; 

'"4 private static final String mismatch = "this option is not valid for this ActionTask 

C Type " ; 

y private Type type; 

jO /** 

* create a ActionTask of a specific type 

* ©param t create an ActionTask of this type 

1 */ 

I s public ActionTask (Type t) { 
3 super (t . name , false); 

^ type = t ; 



I -k-k 

* set the dest option 

* the URL of the card to display or invoke in the GO, GOSUB, RETURN, or CANCEL 

ActionTasks 

* ©param url String destination for this action task 
*/ 

public void setDest (String url) { 

if (type == GO | | type == GOSUB | | type RETURN | | type == CANCEL) 
; // ok 

else 

throw new Inval idHDMLExcept ion (mismatch) ; 
addAttribute ( new Attribute ( "DEST" , url, false) ); 

} 



/ * * 

* specifies a single name^value variable pair to set in the current (in the case of GO) 

* or sub (in the case of SUB) activity. 

* each pair will be appended to the URL-style vars String value 

* ©param name String variable name 

* ©param value String variable default value 
*/ 
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public void setVar (String name, String value) { 

if {type == GO | | type == GOSUB) 
; // ok 

else 

throw new I nvalidHDMLExcept ion (mismatch) ,* 

Attribute vars = getAttribute ( "VARS" ) ; 
String varString = name + "=" + value + ; 

if (vars null) 

varString = vars - getValue ( ) + varString; 

// overwrite the old VARS Attribute 
addAttribute (new Attribute ( "VARS " , varString) ) ; 
vars = null ; 

} 



I * * 

* set the RECEIVE option 

* when invoking a card with the GOSUB ActionTask the RECEIVE option specifies the names * 

of the 

* variables to assign the return values to 

* based on position 

* ©param variables list of variables to receive values from a GOSUB ActionTask 
*/ 

public void setReceiveList (String variables []) { 

if (type ! = GOSUB) 

throw new I nvalidHDMLExcept ion (mismatch) ; 

StringBuffer sb = new StringBuf f er ( 128 ) ; 
for (int i = 0; i < variables . length; i++) { 

sb.append( variables [i] ); 

sb . append { " ; " ) ; 

} 

String s = sb . toString (). trim () ; 

// remove that trailing ,- 

s = s . substring ( 0 , s.lengthO - 1) ; 

addAttribute { new Attribute ( "RECEIVE" , s) ); 



/ * * 

* set the RETVALS option 

* when returning from a sub-activity with the RETURN ActionTask, the RETVALS option 

specifies 

* the values to return to the invoking activity 

* values are positional 

* ©param retVals array of values to return from the task 
*/ 

public void setRetvals (String retVals [] ) { 

if (type ! = RETURN) 

throw new I nvalidHDMLExcept ion (mismatch) ; 

StringBuffer sb = new StringBuf fer (128) ; 
for (int i = 0; i < retVals . length; i++) { 

sb. append ( retVals [i] ); 

sb . append ( " ; " ) ; 

} 

String s = sb . toString ( ) .trim() ; 

// remove that trailing ; 

s = s . substring ( 0 , s - length ( ) - 1); 
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addAt tribute ( new Attribute ( "RETVALS" , s) ); 



/* * 

* set the NEXT option 

* the next option specifies the destination to go to after the sub-activity returns 

* ©param destination URL to go to when the action is executed 
*/ 

public void setNext (String destination) { 

if (type ! = GOSUB) 

throw new I nvalidHDMLExcept ion (mismatch) ; 



} 



addAttribute ( new Attribute ( "NEXT" , destination) ); 



/ * * 

* set the CANCEL option 

* when invoking a sub-activity with the GOSUB ActionTask, the CANCEL option specifies * 

the 

* destination to go to if the sub-activity is cancelled 

* ©param destination URL to go to when the action is executed 
□ */ 

if§ public void setCancel (String destination) { 
p a if (type != GOSUB) 

"~-4 throw new I nvalidHDMLExcept ion (mismatch) ; 

addAttribute ( new Attribute ( "CANCEL" , destination) ); 

W > 

IS 

/* * 

Izz, * the SENDREFERER option specifies whether the user agent should indicate the URL of the 
M * referring deck when requesting the DEST, NEXT, CANCEL decks from the server 
!p * ©param boolean if true then send referer URL 

o */ 

^ public void setSendRef erer (boolean b) { 

O if (type == GO | | type = = GOSUB) 
; // ok 
else 

throw new Inval idHDMLExcept ion (mismatch) ; 
String val = ( (b) ? "true" : "false") ; 

addAttribute ( new Attribute ( "SENDREFERER" , val, false) ); 

} 

/* * 

* set the friend option to indicate that the sub-activity is friendly 

* ©param boolean if true then the sub-activity is friendly 
*/ 

public void setFriend (boolean b) { 

if (type != GOSUB) 

throw new I nvalidHDMLExcept ion (mismatch) ; 

String val = ( (b) ? "true" : "false"); 

addAttribute ( new At tribute ("FRIEND", val, false) ) ,- 

} 

f * * 

* set the clear option to indicate that the sub-activity is clearly 
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* used by RETURN and CANCEL to unset all calling activity's variables 

* ©param boolean if true clear the subactivity 
*/ 

public void setClear (boolean b) { 

if (type == RETURN | | type = = CANCEL) 

; // ok; 
else 

throw new invalidHDMLExcept ion (mismatch) ; 

String val = ( (b) ? "true" : "false"); 
addAttribute( new Attribute ( "CLEAR" , val, false) ); 

} 



J -k * 

* set the NUMBER option - specifies the phone number for a CALL ActionTask 

* ©param value the phone number String 
*/ 

public void setNumber (String value) { 

if (type != CALL) 

throw new Inval idHDMLExcept ion (mismatch) ; 

addAttribute ( new Attribute ( "NUMBER" , value) ); 



ft? /** 

•■4 * ©return String typename 

1= */ 

\\ public String ge t Typename ( ) { return type. name; } 



i /** 

* override here so you can embed this tag within the attribute list of an Action 
*/ 

S protected String renderOpenTag ( ) { 

] SfcringBuffer output = new StringBuf f er ( ) ; 

== output . append ( name ) ; 

'* Enumeration enum = attributes . elements { ) ; 

1 while( enum. hasMoreElements ( ) ) 

I output . append { " " + ((Attribute) enum. next Element {)). render ()) ; 
return output . toSt ring () ; 

} 

} // end 
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package com . thinairapps . tag . hdml ; 
import com. thinairapps . tag .* ; 
/** 

* The &lt ;anchor&gt ; element anchors a task to a string of formatted text, often called a 

link. 

* You can specify a link within any formatted text or image. Any one of ActionTasks must be 

* bound to the Anchor for it to be bound to a button on the device and perform some action 

when 

* selected. 

*' 

public class Anchor extends HDMLTag { 
/ * * 

* Create an Anchor without a TAKS or DEST 
*/ 

public Anchor () { super ( "A" , true) ; } 
/ * * 

* Create an Anchor of the given type, destination, and text label 

* ©param type any one of 8 ActionTasks bound to the link 

* ©param dest destination for the action type 

* ©param text label for link 

*/ 

□ public Anchor (Act ionTask. Type type, String dest, Text text) { 
; fj super ( "A" , true) ; 

addAttribute { "TASK" , type . toString ( ) ) ; 
^ addAttribute ( "DEST" , dest ) ; 

''"~4 addChild(text) ; 

■P } 

/** 

'"'4 * Set the task for this anchor 

m * ©param type specifies the way in which the action is carries out (i.e. invoke \£ 
subprocedure ) 

*/ 

M public void setTask (ActionTask . Type type) { 
ip- addAttribute ( "TASK" , type . toString ( ) ) ; 

h > 

y * / * * 

O * Set the destination of this action 
i^s. * ©param dest URL destination 
*/ 

public void setDest (String dest) { 
addAttribute ( "DEST" , dest) ; 

} 



} // end 
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1 



package com . thinairapps . tag . hdml ; 
I * * 

* A line -break tag akin to <BR> in HTML 
*/ 

public class Break extends HDMLTag { 

/** create a new line-break tag */ 
public Break ( ) { 

super ( "BR" , false) ; 

} 

} // end 
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package com. thinairapps . tag . hdml ; 
import com . thinairapps . tag .* ; 



* The base class for all HDML cards 
*/ 

public abstract class Card extends HDMLTag { 
/ * * 

* Build a new Card 

* ©param typeName the type of card to build 

* ©param boolean should the card append a closing tag i.e. < something /> or leave the 

* tag open <something> and wait for a </something> later 
*/ 

protected Card (String typeName, boolean closingTag) { 
super (typeName , closingTag); 

} 



/ * * 

* set the name option of this card 

* if the card has a name then it can be referreed to as a fragment in a destination 

* ©param name the String name of the card 
*/ 

O public void setName (String name) { 

;,n addAttribute ( new Attribute ( "NAME" , name) ); 

-rs 

/ ** 

i\i * set the title option of the card 

* if no title is specified the first text line of the card is used as the title 
M * title is used for: a suggested bookmark name 

VQ * a text entry prompt 

* ©param title String title to be displayed by some browsers at the top of the card 

U */ 

M public void setTitle (String title) { 

111 addAttribute ( new Attribute ( "TITLE" , title) ); 



* ©return String title of the card 
*/ 

public String getTitleO { 

Attribute att = getAttribute ( "TITLE" ) ; 
return att .getValue ( ) ; 



I * * 

* specify a URL to use when bookmarking the card 

* the default is the URL of the current card 

* this option is used to force the bookmark to go to another card (like a NOD I SPLAY 

card) that sets up valirables 

* instead of the current card 

* ©param url String to use when bookmarking the card 
*/ 

public void setBookmark (String url) { 

addAttribute ( new Attribute ( "BOOKMARK" , url) ); 

} 



} // end 
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package com . thinairapps . tag . hdml ; 
import com . thinairapps . tag . * ; 
/* * 

* Represents the CHOICE card. 

* <p> 

* Lets users pick from a list of choices - the initial display content is shown to the user 

* followed by a list of choices. Each choice can have one line of formatted text 

* text defaults to line mode but may optionally be wrapped 
*/ 

public class ChoiceCard extends Card { 

public static class Method { 
private String name; 

private Method (String n) { name = n; } 

public static final Method NUMBER = new Method ( "number" ) ; 
public static final Method ALPHA = new Method ( "alpha" ) ; 



/** 

* create a choice card with a line of text 

* ©param text String to display above the list of choices 
*/ 

public ChoiceCard (String text) { 
super ( "CHOICE" , true) ; 
try { 

addChild( new FormattedLine ( text , true) ); 
} catch (Exception e) { 

throw new invalidHDMLException (e .getMessage ( ) ) ; 

} 

} 



f + * 

* create a choice card with no text and all defaults 
P */ 

IH public ChoiceCard () { 

i"** super ("CHOICE" , true); 

IS } 

. f it* 

* add the display text to this ChoiceCard 

* ©param text the label 
*/ 

public void addText (FormattedLine text) { 
try { 

addChild(text) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e .getMessage ()) ; 

} 

} 



/* * 

* set the method option for this ChoiceCard 

* ©param method defaults to method=NUMBER 
*/ 

public void setMethod (Method method) { 

addAttribute ( new Attribute ( "METHOD" , method. name) ),- 

} 



/** 

* set the KEY option 



C: \tas_source\ThinAirServer\ . . \thinairapps\tag\hdml\ChoiceCard. java 2 

* ©param key indicates the name of the variable in the current activity to be set by * 

this entry 

*/ 

public void setKey (String key) { 

addAttribute( new Attribute ( "KEY" , key) ); 

} 

/** 

* set the DEFAULT 

* ©param def indicates the name of the variable in the current activity to be set by 

this entry 

*/ 

public void setDefault (String def) { 

addAttribute ( new Attribute ( "DEFAULT" , def) ); 

} 

I * * 

* set the key and default options 

* indicates the name of the variable to be set to the choice entry value 

* when that ce is picked 

* an entry is picked when any action (ACCEPT, PREV, SOFT*) is selected 
* 

* default indicates the default value of the variable key - when the card is entered 
3 * if the variable keu is not set it will be assigned the default value 

f% * otherwise default is ignored 

2 * ©param key indicates the name of the variable in the current activity to be set by 

this entry 

"4 * ©param def indicates the name of the variable in the current activity to be set by ^ 
jr; this entry 

u */ 

" public void setKey (String key, String def) { 

-4 addAttribute ( new Attribute ( "KEY" , key) ); 

S addAttribute ( new Attribute ( "DEFAULT" , def) ); 

" } 

fl /** 

=^ * ikey indicates the name of the variable to be set to the entru index when 

Z * an entry is picked - the entry index is the posit iion of the currently- selected 

V 1 * choice entry in the choice card 

3 * an index of 0 indicates that no choice entry is selected 

~" * idefault indicates the default selected entry 

* if ikey is not specified, idefault will be applied every time the card is entered 

* ©param key indicates the name of the variable in the current activity to be set by 

this entry 

* ©param def indicates the name of the variable in the current activity to be set by * 

this entry 

*/ 

public void setlKey (String key, String def) { 
addAttribute ( new Attribute (" IKEY" , key) ) ; 
addAttribute ( new Attribute ( " IDEFAULT" , def) ) ; 

} 

/ * * 

* add a choice entry to this card 

* ©param ce the ChoiceEntry to add 
*/ 

public void addChoiceEntry (ChoiceEntry ce) { 
try { 

addChild(ce) ; 
} catch (Exception e) { 

throw new InvalidHDMLExcept ion (e . getMessage ( ) ) ; 

} 

} 
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/** 

* add an action to this Card 

* when an action is specified for a card it overrides any deck actions of that type 

* while the card is visible 
* 

* N.B. all actions must precede any line of text in the hdml document 

* ©param action to bind to some button 

*/ 

public void addAct ion (Action action) { 
try { 

addChi Id (action) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e . getMessage ( ) ) ; 

} 



/ * * 

* choice cards must have one or more choices 

* implement that checking here 
*/ 

public String render ( ) { 

if (getChildrenO .sizeO == 0) 

throw new InvalidHDMLException ( "Choice cards must have >= 1 Choice Entry"); 

return super . render () ; 

} 



// end 
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package com. thinairapps . tag . hdml ; 

import com. thinairapps . tag .* ; 
import java.util.*; 

/ * * 

* Represents a single CE choice entry within a Choice card. 

* In addition to text you can specify a value to be assigned to the variable 

* named in the parent choice card's key option 

*/ 

public class ChoiceEntry extends HDMLTag { 
* 

* create a choice Entry with all defaults 

* ©param text label for this Choice Entry 
*/ 

public ChoiceEntry (String text) { 
thisO ; 
try { 

addChild( new Format tedLine ( text ) ) ,- 
} catch (Exception e) { 

throw new Inval idHDMLExcept ion (e . getMessage ()) ; 

} 

} 



.^fTz J * * 

^3 * create a choice Entry with a name and dest 

\U_ * ©param text label for this Choice Entry 

: y * ©param dest URL destination to go to when the choice is selected 

5 C */ 

Ui public ChoiceEntry (String text, String dest) { 

?*! thisO; 

' h 4 try { 

jjjjyj addChild( new Format tedLine (text) ); 

setDest (dest) ; 

™ } catch (Exception e) { 

M throw new Inval idHDMLExcept ion (e . getMessage ( ) ) ; 

a ) } 



/ * * 

* create a choice Entry with a name, dest, and value 

* ©param text label for this Choice Entry 

* ©param dest URL destination to go to when the choice is selected 

* ©param value to be assigned to the variable named in the choice card's key option 
*/ 

public ChoiceEntry (String text, String dest, String value) { 
thisO ; 
try { 

addChildt new Format tedLine (text) ); 
setDest (dest) ; 
setValue (value) ; 

} catch (Exception e) { 

throw new Inval idHDMLExcept ion (e .getMessage ()) ; 

} 

} 



/ * * 

* create a choice Entry with no text, value, or destination 
*/ 

public ChoiceEntry ( ) { 
super ( "CE" , false) ; 

} 
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/ * * 

* add the display text to this ChoiceEntry 

* ©param text String label for this choice 
*/ 

public void addText (Forma ttedLine text) { 
try { 

addChild( text ) ; 
} catch {Exception e) { 

throw new InvalidHDMLExcept ion (e . getMessage ( ) ) ; 

} 

} 

/ * * 

* set the value to be assigned to the variable named in the choice card's key option 

* ©param value 
*/ 

public void setValue (String value) { 

addAttribute ( new Attribute ( "VALUE" , value) ); 

} 



/ * * 

* adds an ActionTask to this ChoiceEntry and sets the dest attribute 

* ©param dest URL destination to go to when the choice is selected 

*/ 

I -J public void setDest (String dest) { 

r g if (getAttribute ( "TASK" ) == null) addAttribute ( new Attribute ( "TASK" , "GOSUB") ) ; 

3^ addAttribute ( new Attribute ( "DEST" , dest) ); 

: 3 } 

i i f * * 

I^l * set the ActionTask associated with this ChoiceEntry 

* be sure to include all attributes of the Task as attributes of the ChoiceEntry 
IH * ©param task ActionTask 

*' 

is=5 public void se t ActionTask (Act ionTask task) { 

M addAttribute ( new Attribute ( "TASK" , task.getTypename ( ) , false) ); 

III Enumeration enum = task . getAttributes {). elements () ; 

;S while ( enum . ha sMoreEl emen t s ( ) ) 

U J addAttribute ( (Attribute) enum. next E 1 ement ( ) ) ; 

jj } 

! T // end 
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package com . thinairapps . tag . hdml ; 
import com. thinairapps. tag .* ; 
I * * 

* the DISPLAY card is used to give information for the user to read 

* DISPLAY cards can also contain actions 
*/ 

public class DisplayCard extends Card { 
/* * 

* create a display card 
*/ 

public DisplayCard ( ) { 

super ("DISPLAY" , true) ; 

} 

/ * * 

* create a display card 

* ©param text String label 
*/ 

public DisplayCard (String text) { 
this 0 ; 

addText ( new Format tedLine (text ) ); 

o } 



"4 /* * 

E * add an action to this Card 

"l * when an action is specified for a card it overrides any deck actions of that type 
^ * while the card is visible 

SI * 

2 * N.B. all actions must precede any formatted lines in the hdml document 

* ©param action to bind to some button on the device 

°* */ 

iff public void addAction (Action action) { 

II try { 

□ addChi Id (action) ,* 

^ } catch (Exception e) { 

*2 throw new Inval idHDMLExcept ion (e . get Message ()) ; 

□ } 
j. } 

/★ * 

* add a line of formatted text to this DISPLAY card 

* ©param line text to add to card 
*/ 

public void addText (Format tedLine line) { 
try { 

addChild(line) ; 
} catch (Exception e) { 

throw new Inval idHDMLExcept ion (e . getMes sage ()) ; 

} 

} 

} // end 
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package com . thinairapps . tag . hdml ; 
import com. thinairapps . tag .* ; 
/** 

* Represents the ENTRY card. 

* <p> 

* Lets users input an optionally formatted character string - the display content 

* is shown to the user, followed by an area to input characters 

*' 

public class EntryCard extends Card { 



/* * 

* create an entry card with String text 

* ©param text String text to add to top of card 

*/ 

public EntryCard (String text) { 
super ( "ENTRY" , true) ; 
addText ( new Format tedLine (text ) ); 

} 

/ * * 

* create an entry card with String text 

* ©param text String text to add to top of card 

* ©param key indicates the name of the variable in the current activity to be set by 

this entry 

* ©param action to bind to some button on the device 
* / 

public EntryCard (String text, String key, Action action) { 
super ( " ENTRY " , true ) ; 
set Key (key) ; 
addAct ion (action) ; 

addText ( new Format tedLine (text ) ); 



* create a choice card with no text, key, or actioni 
*/ 

public EntryCard () { 

super { " ENTRY " , t rue ) ,- 

} 



/** 

* set the KEY option 

* ©param key value of the KEY attribute 
*/ 

public void setKey (String key) { 

addAttribute ( new Attribute ( "KEY" , key) ); 

} 



/ * * 

* set the DEFAULT option 

* ©param def indicates the name of the variable in the current activity to be set by 

this entry 

*/ 

public void setDefault ( String def) { 

addAttribute ( new Attribute ( "DEFAULT" , def) ); 

} 



/ * * 

* set the KEY and DEFAULT options 
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* indicates the name of the variable in the current activity to be set by this entry 
* 

* default indicates the default value of the variable key - when the card is entered 

* if the variable keu is not set it will be assigned the default value 

* otherwise default is ignored 
* 

* N.B. default must conform to the format optioin if that is set 

* ©param key value of the KEY attribute 

* ©param def indicates the name of the variable in the current activity to be set by 

this entry 

*/ 

public void setKey (String key, String def) { 
addAttribute ( new Attribute ( "KEY" , key) ); 
addAttribute ( new Attribute ( "DEFAULT " , def ) ) ; 

} 



/ * * 

* set the FORMAT optiion - used to specify a format for user input entries 

* ©see http://www.w3c.org/TR/hdml20-6.html for format codes 

* ©param format the format String, i.e. 'm*' for all alphanumeric defaulting to 

lower-case 

*/ 

public void setFormat (String format) { 

addAttribute ( new Attribute ( " FORMAT" , format) ); 

□ } 



hA / * * 

* set the NOECHO option on the text field 
^ * ©param b if true then chars will not be echoed 
ij */ 

u 4 public void setNoEcho (boolean b) { 

Q String val = ( (b) ? "true" : "false") ; 

addAttribute ( new Attribute ( "NOECHO" , val, false) ); 



/ * * 

* set the EMPTYOK option on the text field 

* ©param b if true then an empty input will be accepted 
*/ 

public void set EmptyOK (boolean b) { 

String val « ( (b) ? "true" : "false"); 

addAttribute { new Attribute ( "EMPTYOK" , val, false) ); 

} 

/ ** 

* add an action to this Card 

* when an action is specified for a card it overrides any deck actions of that type 

* while the card is visible 
+ 

* N.B. all actions must precede any line of text in the hdml document 

* ©param action to bind to some button on the device 
*/ 

public void addAct ion (Action action) { 
try { 

addChild (action) ; 
} catch (Exception e) { 

throw new InvalidHDMLExcept ion (e . getMessage ( ) ) ; 

} 



/ * * 

* add a line of formatted text to this DISPLAY card 

* ©param text String text to add to top of card 
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*/ 

public void addText ( Forma ttedLine line) { 
try { 

addChild(line) ; 
} catch (Exception e) { 

throw new I nva 1 i dHDMLExcepti on (e .get Message ()) ; 

} 

} 



} // end 
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package com. thinairapps . tag . hdml ; 
import com. thinairapps . tag .* ; 
/** 

* a subclass of DISPLAY card for displaying errors to the user 
*/ 

public class ErrorCard extends DisplayCard { 
I * * 

* create an error card 
* 

* ©param String error message 
*/ 

public ErrorCard (String error) { 
super ( ) ; 

addText ( new FormattedLine (error, true) ); 

} 

* create an error card 
* 

* ©param String error message 

* ©param String path for ok button 

* ©param String label on ok button 

13 */ 

h f* s public ErrorCard (String error, String path, String label) { 
,J super ( ) ; 

ActionTask task = new Act ionTask (Act ionTask . GO) ; 
hl 4 task. setDest (path) ; 

.lr addAction( new Act ion (Act ion. ACCEPT, task, label) ) ; 
addText ( new FormattedLine (error , true) ); 

) 

;7 // end 
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package com. thinairapps . tag - hdml ; 
import com . thinairapps . tag . * ; 
/* * 

* A line of text, with formatting directives, to add to the card 
*/ 

public class Format tedLine extends HDMLTag { 

/** Instances of this class represent the acceptable alignments */ 
public static class Alignment { private Alignment () { ; } } 
public static Alignment LEFT = new AlignmentO; 
public static Alignment CENTER = new Alignment (); 
public static Alignment RIGHT = new Alignment (); 

private String lineFormat; 
private String alignmentFormat; 

/ * * 

* create a line with no text - a break 
*/ 

public Format t edLine ( ) { 
super ( "<BR>" , false); 

} 



S /** 

J~ * create a line of formatted text 

^ * ©param content String content of the text line 

M * ©param align one of three alignment instances above 

e */ 

\-. public Format tedLine (String content, Alignment align) { 

:e ~ super (content , false); 

g if (align == RIGHT) 

alignmentFormat - " <RIGHT> " ,- 

^ else if (align = = CENTER) 

=? alignmentFormat = "< CENTER > " ; 

n ■ } 



* create a line of formatted text with default alignment (LEFT) 

* ©param content String content of the text line 

* ©param wrap if true then the text will wrap around the screen 
*/ 

public FormattedLine (String content, boolean wrap) { 
super (content , false); 

lineFormat = (wrap) ? "<WRAP>" : " <LINE> " ; 

} 



/ * * 

* create a line of formatted text with all defaults 

* ©param content String content of the text line 
*/ 

public FormattedLine (String content) { 
super (content , false); 

// lineFormat = alignmentFormat = null; 

} 



/ * * 

* set the line format mode 

* ©param b if true then the text will wrap around the screen 
*/ 

public void setWrap (boolean b) { 

lineFormat = (b) ? "<WRAP>" : " <LINE> " ; 

} 
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/ * * 

* set the alignment format mode 

* ©param align one of three alignment instances above 
* / 

public void setAlignment (Alignment align) { 
if (align == RIGHT) 

alignment Format - " <RIGHT> " ,- 
else if (align == CENTER) 

alignment Format = "< CENTER > " ; 

} * 



I * * 

* stick the text content in the name String 

* override this to just render the name (i.e. the text content) 

* without start or end tags 
*/ 

public String render () { 

if (lineFormat == null && alignmentFormat == null) return getNameO; 

if (lineFormat == null) lineFormat = "" ; 

if (alignmentFormat == null) alignmentFormat = ""; 

return lineFormat + alignmentFormat + getNameO; 



// end 
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package com . thinairapps . tag - hdml ,- 
import com . thinairapps . tag . * ; 
/** 

* base class for all tags in the HDML tag hierarchy 
*/ 

public abstract class HDMLTag extends Tag { 
/ * * 

* Create a new HDML tag that may optionally close itself 

* ©param name for this card 

* ©param closingTag if true then this tag closes itself 
*/ 

public HDMLTag (String name, boolean closingTag) { 
super (name, closingTag); 

} 

/ * * 

* Create a HDML tag that closes itself 

* ©param name for this card 
*/ 

public HDMLTag (String name) { 
super(name, false); 

} 

^ // end 



hi 
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package com. thinairapps . tag . hdml ,- 
import com. thinairapps . tag .* ; 
I * * 

* Represents an entire deck of an hdml document. 

* <p> 

* Contains the topmost <HDML> tag, any cards, AND any actions, and the </HDML> 
* 7 

public class HDMLTagDocument extends TagDocument { 
/ * * 

* create a new HDMLTagDocument with markable and public set to true 
*/ 

public HDMLTagDocument ( ) { 
this (true, true); 

} 

I * * 

* create a new HDMLTagDocument 

* with settings for MARKABLE and PUBLIC 

* ©param markable if true then this document is markable 

* ©param pub then this document is public 
*/ 

0 public HDMLTagDocument (boolean markable, boolean pub) { 

super ( 11 HDML" , " text /x- hdml " ) ; 
J getRoot {) .addAttribute ( new Attribute ( "VERSION" , "3.0", false) ); 

=~j setPublic (pub) ; 

^ setMarkable (markable) ; 

5 } 

ji * set the time to live option 

* ©param seconds number of seconds that the deck will be cached by the user agent 
_ * after reception 

y */ 

il public void setTimeToLive ( int seconds) { 

^ getRoot () .addAttribute ( new Attribute { "TTL" , String .valueOf ( seconds) , false) ); 

1 } 

T / * * 

"~ * set the public option 

* ©param b indicates whether deck access control has been enabled for this deck 
*/ 

public void setPublic (boolean b) { 

String val = ( (b) ? "true" : "false"); 

getRoot () .addAttribute ( new Attribute ( "PUBLIC" , val, false) ); 

} 

/ ★ * 

* set the access domain of this document 

* ©param url String domain name, i.e. something.com the access domain is suffix-matched 

against the domain 

* name of a referring url 
*/ 

public void setAccessDomain (String url) { 

if (getRoot () . getAttribute ( "PUBLIC") == null) 

throw new InvalidHDMLException ( "The public option must be set to true before an 
Access Domain can be set"); 



getRoot () .addAttribute ( new Attribute ( "ACCESSDOMAIN" , url) ); 

} 
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/** 

* set the access path of this document 

* ©param path String can be a relative url, i.e. /thinair/docs 
*/ 

public void setAccessPath (String path) { 

if (get Root ( ) . get At tribute ( " PUBLIC" ) == null) 

throw new InvalidHDMLException ( "The public option must be set to true before an *r 
Access Path can be set"); 

getRoot () .addAttribute ( new Attribute ( "ACCESS PATH" , path) ); 

} 



/ * * 

* set the markable option 

* ©param b specifies whether the cards in this deck can be bookmarked or not 
*/ 

public void setMarkable (boolean b) { 

if ( b true && (getRoot ( ) .getAttribute ( "PUBLIC" ) == null)) 

throw new InvalidHDMLException ( "The public option must be set to true before an * 
Markable can be set to true"); 

String val = ( (b) ? "true" : "false") ; 

getRoot () .addAttribute ( new Attribute ( "MARKABLE" , val, false) ); 

a } 



* add an action to the TaggedDocument 

.p: * actions added at this level remain in effect for the life of the deck 

It} * when an action is specified for a card it overrides any deck actions of that type 

l'J } * while the card is visible 

2 * ©param action an Action bound to some button on the device 
W */ 

public void addAct ion (Action action) { 

i=s try { 

;!r getRoot ( ) . addChild (action) ; 

U» } catch (Exception e) { 

O throw new InvalidHDMLException (e .getMes sage ()) ; 

i_L /** 

* add a Card to this Tagged Document 

* ©param c Card to add to the document 
*/ 

public void addCard(Card c) { 
try { 

getRoot () . addChild (c) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e -getMes sage ()) ; 

} 

} 



/ * * 

* when you go to render - there must be >- 1 card added to the deck 
*/ 

public String render ( ) { 

if (getRoot () . getChildren ( ) .size () > 0) 
return super . render () ; 

else 

throw new InvalidHDMLException ( "One or more cards must be added to a deck before 
rendering " ) ; 

} 



} // end 



C: \tas_source\ . . \thinairapps\tag\hdml\HDMLTagDocument . java 



3 
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package com. thinairapps . tag .hdml ; 
import com . thinairapps . tag . * ; 

/** 

* An image tag, supported only by some HDML- rendering devxce 

* 7 

public class ImageTag extends HDMLTag { 
/ * * 

* Create a new HDML Image 

* ©param url location of the device 

* ©param altText to appear if no image can be displayed 
* / 

public ImageTag (String url, String altText) { 
super ("IMG" , false) ; 

addAttribute ( new Attribute ( "SRC" , url) ) ; 
addAttribute ( new Attribute ( "ALT" , altText) ) ; 

} 

/** Create an imagae tag with no url or alt text */ 
public ImageTag () { 

super ("IMG", false) ; 

} 



0 /** 

ZL * ©param iconName name for the icon 

H */ 

'^4 public void setlcon (String iconName) { 

g addAttribute (new Attribute { "ICON" , iconName) ) ; 

ij } 

u 4 /** 

30 * ©param altText to be displayed if the device does not support images 
*/ 

— public void setAltText (String altText) { 

J addAttribute ( new Attribute ( "ALT" , altText) ); 

n } 



i / * * 

3 * set the NAME option 

l * alternative internal graphic representation for the image 

* if an image by name exists it will be used - otherwise one will be downloaded 

* from the src URL 

* this allows user-agents to provide an internal set of generic images identified by * 

name 

* ©param name for this image tag 
*/ 

public void setName (String name) { 

addAttribute ( new Attribute ( "NAME" , name) ); 

} 

/* * 

* ©return String url for this image 
*/ 

public String getSrcO { return (String) getAttribute ( "SRC" ) . getValue ( ) ; } 
} // end 
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package com . thinairapps . tag . hdml ; 

/** 

* represents an invalid tag or document layout 
public class InvalidHDMLExcept ion extends Runt ltneExcept ion ( 
/ * * 

* Create InvalidHDMLExcept ion 

* ©param message carried inside the exception 
*/ 

public InvalidHDMLExcept ion (String message) { 
super (message) ; 

} 

/** create an InvalidHDMLExcept ion with no message */ 
public InvalidHDMLExcept ion ( ) { 
super { "invalid HDML used' 1 ); 

} 

} // end 
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package com . thinairapps . tag . hdml ; 
import com . thinairapps . tag . * ; 
/ * * 

* The NOD I SPLAY card DOES NOT give information for the user to read 

* <p> 

* It immeditately executes its ACCEPT or PREV action all other 

* actions are ignored - this implementation will throw an exception 

* if any other action type is entered 

*' 

public abstract class NoDisplayCard extends Card { 
/** 

* create a display card 
*/ 

public NoDisplayCard { ) { 

super ( "NOD I SPLAY" , true); 

} 

/* * 

* add an action to this Card 

* when an action is specified for a card it overrides any deck actions of that type 

* while the card is visible 

* ©param action to bind to some button on the device 
□ */ 

: fi public void addAct ion (Action action) { 

Action. Type type = action .getType () ; 

if (type == Action. ACCEPT | | type == Action. PREV) 
: p ; // ok 

iti else 

l H throw new Inval idHDMLExcept ion ( "Only Accept and Prev actions are valid for a 

'""4 NOD I SPLAY Card"); 

T try { 

super . addChild (action) ,- 
} catch (Exception e) { 
\ft throw new I nval idHDMLExcept i on (e .get Message ()) ; 

} 



!□ // end 
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package com. thinairapps . tag . hdml ; 
import com . thinairapps . tag . * ,- 
/ * * 

* Represents the ENTRY card 

* <p> 

* let users input an optionally formatted character string - the display content 

* is shown to the user, followed by an area to input characters 

* / 

public class PasswordEntryCard extends EntryCard { 

/** create a blank PasswordEntryCard with no destination */ 
public PasswordEntryCard ( ) { 
super ( ) ; 

setNoEcho (true) ; 

} 



/** 

* create a password entry card 

* upon completion of password the next card in the deck 

* is identified by dest 

* ©param dest maps dest to $(username) 
*/ 

public PasswordEntryCard (String dest) { 
this (dest, " $ (username) " ) ; 

} 



* create a password entry card 

* upon completion of password the next card in the deck 

* is identified by dest 
* 

* ©param dest String url to go to when the password is entered 

* ©param username name of user of this card 

*/ 

public PasswordEntryCard (String dest, String username) { 
super ( ) ; 

setName ( "passwordCard" ) ,- 
set Key ( "password" ) ; 
setTitle ( "Enter Password:"); 

ActionTask task - new ActionTask (ActionTask.GOSUB) ; 
task . setVar ( "password" , " $ (password) " ) ; 
task. setDest (dest) ; 

addAction( new Action (Act ion. ACCEPT, task, "Next") ) 

setNoEcho ( true) ; 
setEmptyOK( false) ; 

if (username != null) addText ( new FormattedLine ( "User : "+username) ); 
addText ( new FormattedLine { "Password : " ) ) ; 

} 



/ * * 

* create a password entry card 

* upon completion of password the next card in the deck 

* is identified by dest 
* 

* ©param dest String url to go to when the password is entered 

* ©param username name of user of this card 
*/ 

public PasswordEntryCard (String dest, String key, String username) { 
super ( ) ; 



C: \tas source\ . . \thinairapps\tag\hdml\PasswordEntryCard . java 



2 



setName { "passwordCard" ) ; 
set Key (key) ; 

setTitle ( "Enter Password:"); 

ActionTask task - new Act ionTask (ActionTask . GOSUB) ; 
task . setVar ( "password" , "$ (password) 11 ) ; 
task . setDest (dest ) ; 

addAction( new Action (Action . ACCEPT, task, "Next") ); 

setNoEcho ( true) ; 
setEmptyOK( false) ; 

if (username != null) addText ( new Forma ttedLine ( "User : "+username) ); 
addText ( new Format tedLine ( "Password : 11 ) ) ; 

} 

} // end 
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package com. thinairapps . tag .hdml ; 
/** . 

* This class allows you to insert an arbitrary String 

* into a HDML Deck. 
*/ 

public class Text extends HDMLTag { 
/ * * 

* Create a new Text Object with the given String 

* ©param text String text for this tag 
*/ 

public Text (String text) { 
super ( text , false) ,- 

} 

/ * * 

* ©return String you used to define this Text Object 
*/ 

public String getTextOnly ( ) { 
return getName ( ) ,- 

} 

/ * * 

* ©return Sting HDML markup for this object 

d */ 

*0 public String render ( ) { 
s5% return getName ( ) ; 

!J } 

,p // end 
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/ * * 

* @ (#) WAPDevice . java 
*/ 

package com. thinairapps .plat form, device; 

import j avax . servlet . * ; 
import j avax. servlet .http. * ; 

/ * * 

* ThinAirApps abstraction for a WAP device 

*' • / 

public class WAPDevice extends HTTPDevxce { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 2962217947595361097L; 

/* * 

* Constructs a new <code>WAPDevice</code> instance of the type represented by profile. 

* ©param profile <code>WAPDeviceProf ile</code> prototype for this device instance 

*/ 

WAPDevice (WAPDeviceProf ile profile) { 
super (profile) ; 

} 

jj^j / * * 

If* * Retrieves the content encoding type supported by this device. 

'. * 

\U * ©return <code>String</code> content type supported by this device. 

H */ , 

public String getContentType () { 
'= - return WAPDeviceProf ile . WMLJJSER_CONTENT_TYPE ; 

S } 
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* @ (#) WAPDeviceProf ile . java 
*/ 

package com. thinairapps . platform. device ; 

import javax. servlet .* ; 
import javax. servlet . http .* ; 

/** 

* implements ThinAirApps 1 s standard <code>DeviceProf ile</code> and <code>Device</code> * 

factory for WAP devices 

*/ 

public class WAPDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 334116101350320763L; 

/** name of this device profile */ 

public static final String NAME = "TA_WAP" ,- 

/** content type accepted by all devices matching this profile 
static final String WML_USER_CONTENT_TYPE = " text/vnd. wap . wml » ; 

5* /** alternate content type accepted by all devices matching this profile */ 

2 static final String WML_USER_CONTENT_TYPE2 = " text /x- wap . wml " ; 

M /** alternate mime type indicating wml compliance */ 

£ static final String WMLJJSER_CONTENT_TYPE3 = "application/vnd. wap. wmlc" ; 
M / ** 

'"4 * Retrieves the <code>Class</code> of the <code>Device</code> object that this profile * 
Q creates . 

* 

* ©return <code>Class</code> of the <code>WAPDevice</code> instances that this profile * 
J generates . 

n */ 

^ public Class getDeviceClass {) { return new WAPDevice (this) .getClass (); } 

3 / * * 

T * Retrieves the friendly name of this device type description. 

~- * 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 

Device Prof ile</code> 

*/ 

public String getName ( ) { return NAME; } 
/* * 

* Determines whether the actual device making a request is of the type represented by 

* < code >W APDe v i c e P r o f ile</code> . 
* 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 
★ 

* ©return <code>boolean</code> true if the requesting device is of type < c ode >WAPDe vice ^ 

</code>, false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check Accept header 
HttpServletRequest request = (HttpServletRequest ) req; 
String accept = request . getHeader ( "Accept " ) ,- 



return ( (accept 1= null ) && (accept . indexOf ("wap. wml") >= 0) ) ; 

} 
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return false; 



/ * * 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 
* 

* ©param req the actual < code > S e rvl e tRequest</ code > received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest ) req; 
WAPDevice device = new WAPDevice (this) ; 

// need to check for presence of x-up-subno, if not there, do not set GUID 

String tempGUID = request . getHeader ( "x-up- subno" ) ; 

if (tempGUID != null) device . setGUID ( NAME + " : " + tempGUID ); 

// ACCEPT 

device . setAccept ( request . getHeader ( "Accept " ) ) ; 
// USER- AGENT 

String tempUserAgent = request . getHeader ( "User-Agent ") ; 

device. setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 
// COOKIES 

device . setCookies (request .getCookies ()); 
return device ; 



/ * * 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO_VALUE constant. 

* 

* ©param guid unique device ID - may be null 
* 

* ©return a <code>Device</code> object representing an actual device 
*' 

public Device createDevice (String guid) { 

WAPDevice device = new WAPDevice (this) ; 
device . setGUID (guid) ; 

// inintialize properties to NO__VALUE 
device . setUserAgent (STRING_NO_VALUE) ; 

return device ; 



} // end 
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I * * 

* @(#)UPWAPDeviceProf ile . java 
*/ 

package com. thinairapps . platform . device ; 

import javax. servlet . * ; 
import javax. servlet .http .* ; 

/ * * 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory for up.com WAP phones 

*/ 

public class UPWAPDeviceProf ile extends WAPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -2773505273328761059L; 



/** name of this device profile */ 

public static final String NAME = "TA_UP_WAP" ; 

/** user-agent transmitted with every request coming from devices matching this profile 
*/ 

static final String US ER__AGENT = "UP"; 
/ * * 

* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 

creates . 

* 

* ©return <code>Class</code> of the < code >UPWAPDevice</ code > instances that this profiled 

generates . 

*/ 

public Class getDeviceClass ( ) { 

return new UPWAPDevice (this) .getClass () ,- 

} 

* Retrieves the friendly name of this device type description. 
* 

* ©return <code>String</code> A friendly name callers can u'se to refer to this <code> 

DeviceProf ile</code> 

*/ 

public String getName ( ) { return NAME; } 
/ * * 

* Determines whether the actual device making a request is of the type represented by 

* <code>UPWAPDeviceProf ile</code> . 
* 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>boolean</code> true if the requesting device is of type <code> ^ 

UPWAPDevice</code> , false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent header 
HttpServletRequest request = (HttpServletRequest ) req ; 
String userAgent = request . getHeader ( "User- Agent " ) ; 

return ( (userAgent != null ) && (userAgent . indexOf (USER_AGENT) >= 0) ) ; 

} 



return false; 

} 
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/ * * 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 
* 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the * 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest ) req; 
UPWAPDevice device = new UPWAPDevice (this) ; 

// declare temp values for device properties, to check for null 
String tempGUID, 

tempUser Agent , 

tempLanguage , 

tempFax, 

tempCharset , 

tempHost, 

tempSmartDial ing, 

tempScreenDepth, 

tempColor, 

tempAlert , 

tempPDU, 

tempSof tKeys , 

tempScreenChars , 

tempPixels ; 



II initialize temps 
\r\ tempGUID = request . getHeader ( "x-up-subno" ) ; 

''-^ tempUserAgent = request .getHeader ("User-Agent"); 

\_ tempLanguage = request . getHeader ( "Accept -Language ") ; 

Q tempFax = request . getHeader ( "x-upf ax-accepts " ) ; 

if* tempCharset = request .getHeader ( "accept -charset " ) ; 

]~ tempHost = request .getHeader ("Host") ; 

^ tempSmartDial ing = request .getHeader { "x-up-devcap-smartdialing" ) ; 

IP tempScreenDepth = request .getHeader ( "x-up-devcap- screendepth" ) ; 

53 tempAlert = request .getHeader ( "x-up-devcap- immed -alert 11 ) ; 

j~ tempColor = request .getHeader ( "x-up-devcap- iscolor" ) ; 

^ tempPDU = request .getHeader ( "x-up-devcap -max- pdu" ) ; 

tempSof tKeys = request .getHeader ( "x-up-devcap -numsoft keys " ) ; 

tempScreenChars = request .getHeader ( "x-up-devcap-screenchars " ) ; 

tempPixels = request .getHeader ( "x-up-devcap- screenpixels ") ; 



// * *NEED TO VERIFY IF THIS IS ALWAYS UNIQUE** - gordogre 10/18/2000 

if (tempGUID != null) device . setGUID ( UPWAPDeviceProf ile .NAME + " : " + tempGUID ); 

// COOKIES 

device . setCookies (request . getCookies ()); 
// ACCEPT 

device. setAccept (request .getHeader ("Accept") ) ; 
// USER- AGENT 

device. setUserAgent ( (tempUserAgent == null) ? S TR I NG_NO__V ALUE : tempUserAgent); 
// ACCEPT -LANGUAGE 

device. language = (tempLanguage == null) ? S TR I NG_NO_VALUE : tempLanguage; 
// ACCEPT- FAX 

device .acceptFax = (tempFax == null) ? S TR I NG_N0_V ALUE : tempFax; 
// ACCEPT -CHARSET 
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device. acceptCharset = (tempCharset == null) ? STR I NG_NO_VALUE : tempCharset ,- 

// HOST 

device -host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 

// SMART DIALING 

if (tempSmartDialing != null) 

device . smartDialing = tempSmartDialing . equals ("1") ? true : false; 

// SCREEN DEPTH 

if (tempScreenDepth != null) 

{ 

try 

device . screenDepth = Integer .parselnt ( tempScreenDepth) ; 

} 

catch (Exception e) 

{ 

device . screenDepth = INT_NO_VALUE ; 

} 

} 

else 

{ 

device . screenDepth = INT_NO_VALUE ; 



// IS COLOR 

if (tempColor != null) 

device. isColor = tempColor . equals ("1") ? true : false; 

// IMMEDIATE ALERT 

if (tempAlert != null) 

device. immediateAlert = tempAlert . equals ("1") ? true : false; 

// MAX PDU 

device. maxPDU = (tempPDU = = null) ? S TR I NG_NO_V ALUE : tempPDU; 

// NUMBER OF SOFT KEYS 
if (tempSof tKeys 1= null) 

{ 

try 

device . sof tKeys = Integer . parselnt ( tempSof tKeys ) ; 

} 

catch (Exception e) 

{ 

device . sof tKeys = INT_NO_VALUE ,- 

} 

} 

else 
{ 

device. sof tKeys = INT_NO_VALUE ; 

} 

// SCREEN CHARACTERS 

device. screenChars = (tempScreenChars == null) ? STRING__NO_VALUE : tempScreenChars ; 

// SCREEN PIXELS 

if ( tempPixels != null) 

{ 

try 

device. pixelWidth = Integer . parselnt ( tempPixels . substring (0, tempPixels 
. indexOf (",">)); 

device. pixelHeight = Integer . parselnt (tempPixels . substring (tempPixels. ^ 
indexOf ( " , " ) + 1) ) ; 



C: \TASS\ . ■ \thinairapps\platf orm\device\UPWAPDeviceProf ile . java 

} 

catch (Exception e) 

{ 

// This shouldn't kill everything, so we'll quietly catch it 
device. pixelHeight = INT_N0_VALUE ; 
device. pixelWidth = INTNOJVALUE; 

} 

} 

else 

{ 

device. pixelHeight = lNT_NO_VALUE; 
device. pixelWidth = INT_NO_VALUE ; 

} 



.y 



} 



return device; 



/ * * 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconf igure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 
NO_VALUE constant . 

* 

* oparara guid unique device ID - may be null 
* 

* ©return a <code>Device</code> object representing an actual device 
public Device createDevice (String guid) { 

UPWAPDevice device = new UPWAPDevice (this) ; 

3 device . setGUID ( guid ),- 

fJ // inintialize properties to NO_VALUE 

^ device. setUserAgent <STRlNG_NO_VALUE) ; 

Fl device, language = STRING_NO_VALUE ; 

device. acceptFax = STRING_NO_VALUE ; 
"7 device, accept Charset = STRlNG__NO_VALUE ; 

? " device. host = STRING_NO_VALUE ; 

device . screenDepth = INT_NO_VALUE ; 

device. maxPDU = STRING_NO_VALUE ; 

device. softKeys = INT_NO_VALUE ; 

device. screenChars = STRING_NO_VAIjUE ; 

device. pixelWidth = INT_NO_VALUE ; 

device . pixelHeight = INT_NO_VALUE ; 

return device; 

} 

} // end 
/* 

Content-Type : application/x-www- f orm-urlencoded 
Accept -Charset : ISO-8859-1, UTF-8, * 
x-up-subno: prof ix_LT-CT- 6220 
x-upf ax-accepts : none 
x-up-devcap-charset : ISO-8859-1 

Accept : application/x-hdmlc, application/x-up-alert , application/x-up-cacheop, application/ \£ 
x-up-device # application/x-up-digestentry , application/vnd . wap . wml , text/x-wap . wml , text/wT 
vnd.wap.wml, application/vnd . wap . wml script , text/vnd . wap .wml script , application/vnd. * 
uplanet. channel, application/vnd. uplanet . list , text/x-hdml, text/plain, text/html, image/ 
vnd . wap . wbmp , image/bmp, application/ remote -printing text/x-hdml ;version=3 . 1 , text/x-hdml * 
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;version=3 . 0 , text/x-hdml ; version=2 . 0 , image/bmp, text/html 
User-Agent: ALAV UP/4.0.10 UP . Browser/ 4.0. 10 -XXXX UP . Link/4 . 1 . HTTP-DIRECT 
*/ 
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/** 

* @(#)UPWAPDevice . java 
*/ 

package com. thinairapps . platform. device ; 

import javax. servlet .* ; 
import javax. servlet . http .* ; 

/** 

* ThinAirApps 1 s abstraction for up.com WAP phones 
*/ 

public class UPWAPDevice extends WAPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = - 904702914403 1715525L; 

protected boolean smartDialing ; 

protected boolean isColor; 

protected boolean immediateAlert ; 

protected int softKeys; 

protected int screenDepth; 

protected int pixelWidth; 

protected int pixelHeight; 

protected String language; 
»i protected String maxPDU; 
~" protected String screenChars; 
~ protected String host; 
Si protected String acceptFax; 
%J protected String acceptCharset; 

XJ / * * 

tj * Constructs a new <code>UPWAPDevice</code> instance of the type represented by profile. 
* 

fe * ©param profile <code>UPWAPDeviceProf ile</code> prototype for this device instance 
*/ 

□ UPWAPDevice (UPWAPDeviceProf ile profile) { 
ri super (profile) ; 

3 } 

n /** 

h * Retrieves a value indicating whehter the device accepts UP faxes. 

* <p> 

^ * Value is typically "1" if device does accept faxes, "0" if it does not. 

★ 

* ©return <code>String</code> accepts UP-Fax 

*/ , 
public String getAcceptFax ( ) { return acceptFax; } 

/ * * 

* Retrieves the character encoding set supported by the device. 
* 

* ©return <code>String</code> character set supported by device */ 
public String getAcceptCharset { ) { return acceptCharset; } 

f * * 

* Retrieves the language locale supported by the device. 
* 

* ©return <code>String</code> language locale, if specified 
*/ 

public String getLanguage ( ) { return language; } 
/** 

* Retreives flag indicating if smart dialing is enabled on this device. 
* 

* ©return < code >bool ean< / code > true if smart dialing enabled, false otherwise 
*/ 
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public boolean isSmartDialing ( ) { return smartDialing ; } 
I * * 

* Retrieves the screen depth of this device. 
* 

* ©return <code> int < /code > screen bit depth 
public int getScreenDepth ( ) { return screenDepth; } 
I * * 

* Retreives flag indicating whether this is a color device. 

* ©return < code >boolean</ code > true if device is color, false otherwise 
*/ 

public boolean isColorO { return isColor; } 
/ * * 

* Retreives flag indicating if immediate alert is enabled on this device. 
* 

* ©return <code>boolean</code> true if immediate alert enabled, false otherwise 
*/ 

public boolean immediateAlert ( ) { return immediateAlert ; } 
/ * * 

* Retrieves the maximum size of PDU's this device supports. 

* ©return <code>String</code> max PDU 

is */ 

'-•■A public String getMaxPDUO { return maxPDU; } 

=r /** 

UJ * Retrieves the number of soft keys on this device. 

~"-\ * 

-Jl * ©return <code>int</code> number of soft keys 
W */ 

1 public int numSof tKeys ( ) { return softKeys; } 

i» I ** 

:fj * Retrieves the dimension of the devices screen in terms of characters . 

Q * The format for this value is: "H,V" , where H is horizontal characters (rows) and V is ^ 

iff vertical characters (columns) - 

i'~ * ©return <code>String</code> screen characters 

li */ 

public String getScreenChars ( ) { return screenChars ; } 
/ * * 

* Retreives the width of the device's screen in pixels. 
* 

* ©return <code>int</code> screen pixel width 
*/ 

public int getPixelWidth { ) { return pixelWidth; } 
/ * * 

* Retrieves the height of the device's screen in pixels. 
* 

* ©return <code>int</code> screen pixel height 
*/ 

public int getPixelHeight ( ) { return pixelHeight; } 
} // end 
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I * * 

* @(#)TellMeDeviceProf ile . java 
*/ 

package com. thinairapps .platform. device ; 

import javax. servlet .* ; 
import javax. servlet . http .* ; 

/ * * 

♦implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> * 
factory for HDML devices 

*/ 

public class TellMeDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 2489998979065444352L; 

/** name of this device profile */ 

public static final String NAME = " TA_TELLME " ; 

/** content type accepted by all devices matching this profile */ 
protected static final String CONTENT_TYPE = "text/xml"; 

3 / ** 

5? * Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 
Tl creates. 

M * 

H * ©return <code>Class</code> of the <code>TellMeDevice</code> instances that this 
ijf profile generates. 

n */ 

^ public Class getDeviceClass ( ) { 

return new TellMeDevice (this) .getClass (); 

a } 

Ms 

fi * Retrieves the friendly name of this device type description. 

£ * ©return <code>String</code> A friendly name callers can use to refer to this <code> *r 
U DeviceProf ile</code> 

3 */ 

_l public String getName ( ) { return NAME; } 
/ * * 

* Determines whether the actual device making a request is of the type represented by 

* <code>TellMeDeviceProf ile</code> . 
* 

* oparam request the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>boolean</code> true if the requesting device is of type <code> ^ 

TellMeDevice</code> , false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User- Agent header 
HttpServletRequest request = (HttpServletRequest ) req ; 
String userAgent = request . getHeader ( "User- Agent " ) ,- 

return ( (userAgent 1= null ) && 

(userAgent . equals ( "Tellme/l . 0 (I; en-US)") || userAgent . equals ^ 
("libwww-perl/5.47") ) ) ; 

} 



return false; 

} 
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/** 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 
* 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest ) req,- 
TellMeDevice device = new TellMeDevice (this) ; 

// no known value to use for GUID, so do not set 

// USER -AGENT 

String tempUser Agent - request . getHeader ( "User-Agent ") ; 

device . setUserAgent ( ( tempUser Agent == null) ? S TR I NG_NO_V ALUE : t empUser Agent ) ; 
// COOKIES 

device . setCookies ( request . getCookies ( ) ) ; 
// ACCEPT 

device . setAccept ( request . getHeader ( "Accept " ) ) ; 
return device ; 



/* * 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconf igure an account 

* to include a device. 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO_VALUE c on s t an t . 

* 

* ©param guid unique device ID - may be null 
* 

* ©return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

TellMeDevice device = new TellMeDevice ( this) ,* 

// TellMeDevice device does not have GUID, so do not set 

// inintialize properties to NO_VALUE 
device . setUserAgent ( STRI NG_NO_VALUE ) ,- 

return device ,- 



} // end 
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/ * * 

* @ (#) Tel lMeDevice . java 

package com . thinairapps . platform . device ; 

import j avax . servlet . * ; 
import j avax. servlet .http. * ; 

/ * * 

* ThinAirApps ' s abstraction for the TellMe browser 

V • r 

public class TellMeDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -3692689441219031923L; 

/** 

* Constructs a new <code>TellMeDevice</code> instance of the type represented by profiled 

* ©param profile <code>TellMeDeviceProf ile</code> prototype for this device instance 
*/ 

TellMeDevice (TellMeDeviceProf ile profile) { 
super (prof ile) ; 

} 



* Retrieves the content encoding type supported by this device. 
in * 

* ©return <code>String</code> content type supported by this device. 

public String getContentType ( ) { 
W return TellMeDeviceProf ile . CONTENT_TYPE ; 

'*J } 

'1 // end 
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/ * * 

* @ (#) PocketlEDeviceProf ile . java 
*/ 

package com. thinairapps .platform. device; 

import javax. servlet .* ; 
import javax. servlet .http. * ,- 

/ * * 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> x 

factory for Pocket IE devices 

* / 

public class PocketlEDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUlD for compatability with previous versions 
static final long serial VersionUID = 4004923160351708628L; 

/** name of this device profile */ 

public static final String NAME = " TA_P0CKETI E " ; 

/** content type accepted by all devices matching this profile */ 
public static final String CONTENT_TYPE = "text/html"; 

/** user agent transmitted with every request from this device */ 
~= public static final String US ER_AGENT = "Mozilla/2 . 0 (compatible; MSIE 3.02; Windows 
S CE)"; 

-J. / * * 

§S * Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 

^ creates . 

XJ * 

■=J * ©return <code>Class</code> of the <code>PocketIEDevice</code> instances that this 
profile generates . 

*/ 

public Class getDeviceClass ( } { 
3 return new PocketlEDevice (this) .getClass () ; 

P } 

n / ** 

3 * Retrieves the friendly name of this device type description. 
™ * 

555 * ©return <code>String</code> A friendly name callers can use to refer to this <code> 
DeviceProf ile</code> 

*/ 

public String getName ( ) { return NAME; } 
/ ** 

* Determines whether the actual .device making a request is of the type represented by 

* <code>PocketIEDeviceProf ile</code> . 
* 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>boolean</code> true if the requesting device is of type <code> 

PocketIEDevice</code> , false otherwise. 

*/ 

public boolean isRequestFromDevice ( ServletRequest req) { 

if (super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent header 
HttpServletRequest request - (Ht tpServletRequest ) req ; 
String userAgent = request . getHeader ( "User-Agent ") ; 

return ( (userAgent 1= null ) && (userAgent . indexOf ( "Windows CE") >= 0)); 

} 

return false; 
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} 



I * * 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 
* 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest ) req; 
PocketlEDevice device = new PocketlEDevice (this) ; 

//no known value to use for GUID, so do not set 

// declare temp values for device properties, to check for null 
String tempUserAgent, 

tempHost, 

tempos , 

tempColor , 

tempScreenPixels ; 

// initialize temps 

tempUserAgent = request - getHeader ("User-Agent"); 
tempHost = request .getHeader ( "Host ") ; 
tempos = request .getHeader ("UA-OS") ; 
tempColor = request . getHeader ( "UA- color ") ,- 
tempScreenPixels = request . getHeader ( "UA-pixels " ) ; 

// COOKIES 

device . setCookies ( request . getCookies 0); 
// ACCEPT 

device . setAccept ( request . getHeader ( 11 Accept " ) ) ; 
// USER- AGENT 

device. setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 
// HOST 

device. m_host = (tempHost == null) ? S TRI NG_NO_ VALUE : tempHost; 
// OS 

device. m_os = (tempOS == null) ? STRING_NO_VALUE : tempOS ; 
// COLOR 

device .m_color = (tempColor == null) ? STRING_NO_VALUE : tempColor; 
// SCREEN PIXELS 

device .m_screen = (tempScreenPixels == null) ? S TR I NG_NO_VALUE : tempScreenPixels; 



} 



return device; 



( * * 



/* 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device. 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO VALUE constant. 
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* ©param guid unique device ID - may be null 

* ©return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

PocketlEDevice device = new Pocket IEDevice ( this) ; 

// PocketlE device does not have GUID, so do not set 

// inintialize properties to NO_VALUE 
device . setUserAgent ( S TR I NG_NO_VALUE ) ; 
device. m_host = STRING_NO_VALUE ; 
device. m_os = STRING_NO_VALUE ; 
device. m_color = STRING_NO_VALUE ; 
device .m_s ere en = STRING_NO_VALUE ; 

return device ; 



} // end 



^/Accept: */* 
^p/05/17/2000 02: 
fiQ (POCKET PC) 
□/05/17/2000 02: 
2/05/17/2000 02: 
'M/05/17/2000 02: 
111 . 1.1.61/taap 
^/05/17/2000 02: 
s il JavaScript 
^V/05/17/2000 02: 
= gzip, deflat 

^/OB/17/2000 02: 
!~ Mozilla/2.0 
^//05/17/2000 02: 



14:14 PM: 

- Version 

14:14 PM: 
14:14 PM: 
14:14 PM: 

s/html 
14:14 PM: 



BasicHTTPServletRequest .parseRequest : http line: UA-OS: Windows CE y£ 
3.0 

BasicHTTPServletRequest .parseRequest : http line: 

BasicHTTPServletRequest .parseRequest : http line: 

BasicHTTPServletRequest .parseRequest : http line: 



UA-color: color32 
UA-pixelS: 240x320 
Ref erer : http : //10 



BasicHTTPServletRequest .parseRequest : 



14:14 PM: Bas icHTTPServlet Request . parseRequest : 
e 

14:14 PM: BasicHTTPServletRequest . parseRequest : 
(compatible; MSIE 3.02; Windows CE ; 240x320) 
14:14 PM: Bas icHTTPServlet Request . parseRequest : 



http line: 
http line: 
http line: 
http line: 



UA- Language: 
Accept - Encoding : 
User-Agent : \£ 
Host: 10.1.1.61 



;=C5 

05 
05 
05 

05 
05 
05 
*/ 



/17/2000 07:45:34 PM : 

/17/2000 07:45:34 PM : 

() - Version 2 .11 

/17/2000 07:45:34 PM : 

/17/2000 07:45:34 PM : 

/17/2000 07:45:34 PM : 
(586) 

/17/2000 07:45:34 PM : 

/17/2000 07:45:34 PM : 

/17/2000 07:45:34 PM : 



BasicHTTPServletRequest .parseRequest : http line: Host: 10.1.1.61 
BasicHTTPServletRequest .parseRequest : http line: UA-OS: Windows CE 



BasicHTTPServletRequest .parseRequest : http line 
BasicHTTPServletRequest .parseRequest : http line 
BasicHTTPServletRequest .parseRequest : http line 



UA-color : 

UA-pixelS: 640x480 
UA-CPU : Unknown 



BasicHTTPServletRequest .parseRequest : http line: Cookie: 
BasicHTTPServletRequest .parseRequest : http line: Pragma: no-cache 
BasicHTTPServletRequest .parseRequest : http line: Accept: 
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/ * * 

* @ (#) Pocket IEDevice . java 
*/ 

package com . thinairapps .platform. device ; 

import javax. servlet .* ; 
import javax. servlet .http .* ; 

/* * 

* ThinAirApps abstraction for devices supporting Microsoft Pocket IE 
* / 

public class PocketlEDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -3014994380237056646L; 

protected String m_os, m_color, m_screen, m_host; 
I * * 

* Constructs a new <code>PocketIEDevice</code> instance of the type represented by 

profile . 

* ©param profile <code>PocketIEDeviceProf ile</code> prototype for this device instance 
*/ 

« PocketlEDevice ( PocketlEDeviceProf ile profile) { 
= super (profile) ; 

I } 

.1 / * * 

^ * Retrieves the content encoding type supported by this device. 

!=~ * 

|j * ©return <code>String</code> content type supported by this device. 
J */ 

^ public String getContentType () { return PocketlEDeviceProf ile . CONTENT_TYPE ; } 
/ ** 

* Retrieves a description of the operating system running on the device. 

!Z * 

fj * ©return <code>String</code> OS of this device */ 
public String getOS ( ) { return m_os; } 

~ / * * 

=^ * Retrieves the color depth of the screen for the device. 

=== * 

* ©return <code>String</code> color depth of device 
* / 

public String getColorDepth ( ) { return m_color ; } 
/** 

* Retrieves the screen size of the device. 

* <P> 

* The returned value will be in the format "HxW", where H is the height of the screen 

* in pixels, and W is the width of the screen in pixels. 
* 

* ©return <code>String</code> screen size of the device. 
*/ 

public String getScreenSize ( ) { return m_screen; } 
/ * * 

* Retrieves the address of the host targeted by the request . 
* 

* ©return <code>String</code> host targeted by request 
*/ 

public String getHostO { return m_host ; } 



} // end 
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/ * * 

* @ (#) PalmVIIDeviceProf ile . java 
*/ 

package com . thinairapps . platform . device ; 

import j avax . servlet . * ; 
import j avax. servlet .http .* ; 

/ * * 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> * 

factory for Palm VII devices 

*/ 

public class PalmVIIDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 6054987558599139231L; 

/** name of this device profile */ 

public static final String NAME = "TA_PALM_VII » ; 

/** user-agent transmitted with every request coming from devices matching this profile * 
*/ 

// public static final String USE R_AG E NT = "Mozilla/2.0 (compatible; Elaine/1 . 0 )" ; 

;™ /** content type accepted by all devices matching this profile */ 
X iL public static final String CONTENT_TYPE = "text /html " ; 

SB // seems like Elaine sends user-agent as a lower case string 
*uj private static final String userAgentKey = "user-agent"; 

slJ /* * 

^-j * Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 
creates. 



ill 



* ©return <code>Class</code> of the <code>PalmVIIDevice</code> instances that this \£ 

profile generates. 

*/ 

public Class getDeviceClass ( ) { 

return new PalmVIIDevice (this) .getClass (); 

} 

/ * * 

* Retrieves the friendly name of this device type description. 
* 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 

DeviceProf ile</code> 

*/ 

public String getNameO { return NAME; } 
/* * 

* Determines whether the actual device making a request is of the type represented by 

* <code>PalmVIIDeviceProf ile</code> . 
* 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>boolean</code> true if the requesting device is of type <code> ^ 

PalmVIIDevice</code> , false otherwise. 

* / 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req) ) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent header 
HttpServletRequest request = (HttpServletRequest ) req; 
String userAgent = request . getHeader ( "User-Agent " ) ; 



// sgross 12/12/2000: 
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// This change ensures that Elaine servers which are ABOVE 1.* 
// will not be recognized by this profile 

// Reports are that the content -encodings for Elaine/2.* servers will 
// be incompatible with our software 

return { (userAgent != null ) && (userAgent . indexOf ( "Elaine/1 " ) >= 0) ) ; 



return false; 

} 



/ * * 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 
* 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*' 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest ) req; 
PalmVIIDevice device = new PalmVIIDevice (this) ; 



// this may not be present if not originating from our Palm Secure Client - gordogre 
String guid = request . getParameter ("d" ); 
if (guid — null) 

guid = request .getParameter ("did"); 
if (guid = = null) 

guid = request .getParameter ( "deviceid" ) ; 

// if we do not find a suitable guid, we should not set device GUID - gordogre 
if (guid != null) device . setGUID (NAME + " : " + guid); 

// declare temp values for device properties, to check for null 
String tempUserAgent , 

tempHost , 

tempvia, 

tempConnection, 

tempForwardedFor , 

tempElaineVersion; 

// initialize temps 

tempUserAgent = request .getHeader ("User-Agent"); 
tempHost = request .getHeader ( "Host ") ; 
tempvia = request . getHeader ( "Via" ) ; 
tempConnection = request .getHeader ( "Connection" ) ; 
tempForwardedFor = request .getHeader ( "X -Forwarded- For " ) ; 
tempElaineVersion = parseElaineVersion ( tempUserAgent ) ; 



// COOKIES 

device . setCookies (request . getCookies ()); 
// ACCEPT 

device . set Accept ( request . getHeader ( "Accept " ) ) ; 
// USER- AGENT 

device . setUserAgent ( (tempUserAgent == null) ? S TR I NG_NO_VALUE : tempUserAgent) ; 
// VIA 

device. via = (tempvia == null) ? S TR I NG_NO_V ALUE : tempVia; 
// HOST 

device. host = (tempHost == null) ? S TR I NG_NO_VALUE : tempHost; 
// CONNECTION 
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device . connect ionType = ( tempConnection == null) ? STRING_NO_VALUE : tempConnect ion ; 

// FORWARDED- FOR 

device . f orwardAddress = ( tempForwardedFor == null) ? STRING__NO_VALUE : 
temp Forwarded For ; 

// ELAINE VERSION 

device. elaineVersion = (tempElaineVersion == null) ? STRING_NO_VALUE : 
t empE 1 a i ne Ve r s i on ; 



} 



return device; 



I * * 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NOJVALUE constant . 

* 

* ©param guid unique device ID - may be null 

I ~J * 

$Q * ©return a <code>Device</code> object representing an actual device 

m */ 

["".. public Device createDevice (String guid) { 

s p PalmVIIDevice device = new PalmVIIDevice ( this) ; 

device . setGUID ( guid ) ; 

IJ3 1 1 initialize properties to NO_VALUE 

3 device . setUserAgent (STRING_NO_VALUE) ; 

i=i device, via = STRING_NO_VALUE ; 

H device. host = STRING_NO_VALUE ; 

\*2 device .connect ionType = STRING_NO_VALUE ; 

O device, f orwardAddress = STRING_NO__VALUE ; 

device .elaineVersion = STRING NO_VALUE; 



return device; 

Parses User-Agent header to retrieve version of Elaine browser 
* 

* ©param <code>String</code> User-Agent header from request 
* 

* ©return <code>String</code> Elaine version making request, or null if the Elaine * 

version cannot be obtained 

*/ 

private String parseElaineVersion (String ua) 

{ 

String temp; 
int index; 

// first check for null string 
if (ua =- null) 

{ 

return null; 

} 

else 

// obtain index of string preceding version number; i.e. "Mozilla/2 . 0 (compatible^ 

; Elaine/ 1.0) " 
index = ua . indexOf ( "Elaine/ ") ; 
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// now obtain substring begining with versio number 
temp = ua . substring (index + 7) ; 

// obtain ending index of version number 
index = temp . indexOf ( " ) " ) ; 

if (index > 0) 

{ // return substring containing version number only 
return temp - substring ( 0 , index) ; 

} 

else 

{ //if version number not present, return null 
return null; 

} 

} 

} 



} // end 
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/ * * 

* @ (#) PalmVIIDevice . java 
*/ 

package com. thinairapps .plat form. device ; 

import javax. servlet .* ; 
import javax. servlet . http .* ; 

/** 

* ThinAirApps ' s abstraction for the Palm VII PDA 
* / 

public class PalmVIIDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 4619797748056876641L; 

protected String f orwardAddress , host, via, connect ionType , elaineVersion; 
/ ** 

* Constructs a new < code >PalmVI I Devi ce</ code > instance of the type represented by 

profile . 

* ©param profile <code>PalmVIIDeviceProf ile</code> prototype for this device instance 
*/ 

PalmVIIDevice (PalmVIIDeviceProf ile profile) { 
™ super (profile) ,- 

% i > 

im / * * 

h~i * Retrieves the content encoding type supported by this device. 
™ * 

^ * ©return <code>String</code> content type supported by this device. 

W */ 

public String ge t Content Type ( ) { 
i-2 return PalmVIIDeviceProf ile . CONTENT_TYPE ; 

w } 

5 

O /* * 

* Retrieves the connection type for the request. 
jL] * <p> 

M * Typical values are "Keep-Alive" or "Close". 

ITl * 

* ©return <code>String</code> connection type for the request 

H */ 

5^ public String getConnectionType ( ) { return connect ionType ; } 
/ * * 

* Retrieves the IP address of the device . 

* This is not necessarily a unique client IP address! 
* 

* ©return String IP address of device 
*/ 

public String getForwardAddress ( ) { return f orwardAddress ; } 
/ * * 

* Retrieves the address of the host targeted by the request. 
* 

* ©return <code>String</code> host targeted by request 
public String getHost ( ) { return host; } 

/ * * 

* Retrieves the domain of the device's gateway. 
* 

* ©return <code>String</code> domain of request origin (gateway domain) 
*/ 

public String getGatewayO { return via; } 
I * * 

* Retrieves the version of the Elaine browser running on the device. 
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* ©return <code>String</code> version of Elaine browser making request 
*/ 

public String getElaineVersion ( ) { return elaineVersion ; } 



} // end 
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/ * * 

* @ (#) OmniSkyDeviceProf ile . java 
*/ 

package com. thinairapps .platform. device; 

import javax. servlet .* ; 
import javax. servlet .http . * ; 

I * * 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory for OmniSky devices 

*/ 

public class OmniSkyDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 7531455097521934005L ; 

/** name of this device profile */ 

public static final String NAME = "TA_OMNISKY" ; 

/** user-agent transmitted with every request coming from devices matching this profile ^ 
*/ 

static final String CONTENT_TYPE = "text/html"; 
iK ~ /** content type accepted by all devices matching this profile */ 
y static final String US E R_AGENT = "Mozilla/2 . 0 (compatible; Elaine/1 . 0 ) " ; 

i tj / * * 

HJ * Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 
^ creates. 

•F^ * 

W * ©return <code>Class</code> of the <code>OmniSkyDevice</code> instances that this 
profile generates. 

*/ 

public Class getDeviceClass ( ) { return new OmniSkyDevice ( this) .getClass ( ) ; } 

;S=5 / * * 

:fJ * Retrieves the friendly name of this device type description. 

if! * ©return <code>String</code> A friendly name callers can use to refer to this <code> ^ 
i~ DeviceProf ile</code> 

li */ 

5™" public String getNameO { return NAME; } 
/ * * 

* Determines whether the actual device making a request is of the type represented by 

* <code>OmniSkyDeviceProf ile</code> . 
* 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>boolean</code> true if the requesting device is of type <code> ^ 

OmniSkyDevice</code> , false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent header 
HttpServletRequest request = (HttpServletRequest ) req; 
String userAgent = request . get Header ( " User - Agent 11 ) ; 

// must also check "via" header, which will contain " OMMD 11 for OmniSky gateways 
String tempVia = request . getHeader ( "Via" ) ; 

return ( (userAgent != null ) && 
(tempVia != null) && 

(userAgent . indexOf ("Elaine" ) >= 0) && 
(tempVia. indexOf ( "OMMD" ) >= 0) ); 
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} 

return false; 

} 

/** 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 
* 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest ) req; 
OmniSkyDevice device = new OmniSkyDevice (this) ; 

// this may not be present if not originating from our Palm Secure Client - gordogre 
String guid = request .getParameter ("d") ; 
if (guid == null) 

guid = request .getParameter ("did"); 
if (guid == null) 

guid = request .getParameter ( "deviceid" ) ; 

*G //if we do not find a suitable guid, we should not set device GUID - gordogre 

IS if (guid != null) device . set GUID (NAME + ":" + guid) ; 

n~ // declare temp values for device properties, to check for null 

\d String tempUserAgent , 

Hj tempHost, 

i-f: tempVia, 

! ^ tempElaineVersion ; 

i 

=2 // initialize temps 

tempUserAgent = request .getHeader ( "User- Agent 11 ) ; 

tempHost = request. getHeader ("Host") ; 
y tempVia = request . getHeader ( "Via" ) ; 

if! tempElaineVersion = parseElaineVersion (tempUserAgent ) ; 

// COOKIES 

^ device . setCookies (request .getCookies ()); 

// ACCEPT 

device . setAccept ( request . getHeader ( "Accept " ) ) ; 
// USER- AGENT 

device . setUserAgent ( (tempUserAgent == null) ? S T R I NG_NO_V ALUE : tempUserAgent); 
// VIA 

device. via = (tempVia == null) ? STRING_NO_VALUE : tempVia; 
// HOST 

device. host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 
// ELAINE VERSION 

device. elaineVersion = (tempElaineVersion == null) ? S TR I NG_NO_V ALUE : 
tempElaineVersion; 

return device; 



/ * * 

* Create a <code>Device</code> from a <code>String</code> device GUID 
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* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO_VALUE constant . 

* 

* ©param guid unique device ID - may be null 
* 

* ©return a <code>Device</code> object representing an actual device 
public Device createDevice (String guid) { 

OmniSkyDevice device = new OmniSkyDevice ( this) ; 

device . setGUID ( guid ) ; 

// initialize properties to NO_VALUE 
device. setUserAgent (STRING_NO_VALUE) ; 
device. via = STRING_NO_VALUE ; 
device. host = S TRI NG_NO_VALUE ; 
device. elaineVersion = STRING NO VALUE; 



} 



return device ; 



/ * * 

* Parses User-Agent header to retrieve version of Elaine browser 
* 

* ©param <code>String</code> User-Agent header from request 
* 

* ©return <code>String</code> Elaine version making request, or null if the Elaine wr 

version cannot be obtained 

*/ 

private String parseElaineVersion (String ua) 

{ 

String temp; 
int index; 

// first check for null string 
if (ua == null) 

{ 

return null ; 

} 

else 

// obtain index of string preceding version number; i.e. "Mozilla/2 . 0 ( compatibles 

; Elaine/ 1.0) 11 
index = ua . indexOf ( "Elaine/ ") ; 

// now obtain substring begining with versio number 
temp = ua . substring ( index + 7) ; 

// obtain ending index of version number 
index = temp . indexOf ('*)") ; 

if (index > 0) 

{ // return substring containing version number only 
return temp . substring ( 0 , index) ; 

} 

else 

{ // if version number not present, return null 
return null; 

} 



} // end 
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/ * * 

* © (#) OmniSkyDevice . java 
*/ 

package com. thinairapps . platform. device ; 

import javax. servlet . * ; 
import javax. servlet . http .* ; 

/ * * 

* ThinAirApps ' s abstraction for OmniSky-enabled devices 

*' . , 

public class OmniSkyDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = - 8857853771839964701L; 

protected String host, via, elaineVersion; 
/ * * 

* Constructs a new <code>OmniSkyDevice</code> instance of the type represented by 

profile . 

* ©param profile <code>OmniSkyDeviceProf ile</code> prototype for this device instance 
*/ 

OmniSkyDevice (Omn iSkyDe vice Prof ile profile) { 
i«i super (profile) ; 

S } 

10 /** 

.^1 * Retrieves the content encoding type supported by this device. 
>~ * 

;P * ©return <code>String</code> content type supported by this device. 
I J */ 

d public String getContentType () { 

return OmniSkyDevice Prof ile . CONTENT_TYPE ; 

- } 

J * * 

S * Retrieves the address of the host targeted by the request . 
L. * 

==? * ©return <code>String</code> host targeted by request 
f\ */ 

^ public String getHost ( ) { return host; } 
^ / ** 

* Retrieves the domain of the device's gateway. 

* ©return <code>String</code> domain of request origin (gateway domain) 
*/ 

public String getGatewayO { return via; } 
/* * 

* Retrieves the version of the Elaine browser running on the device. 
* 

* ©return <code>String</code> version of Elaine browser making request 
*/ 

public String getElaineVersion ( ) { return elaineVersion; } 



} // end 
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1 * * 

* @ {#) NokiaWAPDeviceProf ile . java 
*/ 

package com. thinairapps .platform. device; 

import javax. servlet .* ; 
import javax. servlet .http. * ; 

/♦♦implements ThinAirApps 1 s standard <code>DeviceProf ile</code> and <code>Device</code> * 
factory for NOKIA WAP phones 

*/ 

public class NokiaWAPDeviceProf ile extends WAPDeviceProf lie { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -7297723379847931620L; 

/** name of this device profile */ 

public static final String NAME = "TA_NOKIA_WAP" ; 

// FIXME FIXME FIXME : set the proper user agent 

/** user-agent transmitted with every request coming from devices-matching this profile 
*/ 

- static final String US ER_AGENT = "nokia-user-agent " ; 
D / * * 

Z\ * Retrieves the <code>Class</code> of the <code>Device</code> object that this profile * 
2, creates. 

ih* * 

: y * ©return <code>Class</code> of the <code>NokiaWAPDevice</code> instances that this ^ 
ij profile generates. 

2 */ 

& public Class getDeviceClass ( ) { 

return new NokiaWAPDevice (this) .getClass (); 

3 } 

3 /** 

?f * Retrieves the friendly name of this device type description. 

!™ * 

^ * ©return <code>String</code> A friendly name callers can use to refer to this <code> wr 
r ^ DeviceProf ile</code> 

*/ 

public String getName ( ) { return NAME; } 
/ ** 

* Determines whether the actual device making a request is of the type represented by 

* <code>NokiaWAPDeviceProf ile</code> . 
* 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code >boolean< / code > true if the requesting device is of type <code> ^ 

NokiaWAPDevice</code> , false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent header 
HttpServletRequest request = (HttpServletRequest ) req ; 
String userAgent = request . getHeader ( "User-Agent ") ; 

return ( (userAgent != null ) && (userAgent . indexOf ( "Nokia" ) >= 0)); 

} 

return false; 
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/ * * 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 
* 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest ) req ; 
NokiaWAPDevice device = new NokiaWAPDevice (this) ,- 

// cannot verify that x-network- inf o will be unique, so do 
// not set GUID - gordogre 

// declare temp values for device properties, to check for null 
String tempUserAgent , 

tempEncoding , 

tempHost, 

tempvia, 

tempLanguage , 

tempCharset , 

tempNet work Info ; 

// initialize temps 

tempUserAgent = request . getHeader ( "User-Agent " ) ; 
tempEncoding = request . getHeader ( "Accept -Encoding" ) ,- 
tempHost = request .getHeader ( "Host" ) ; 
tempVia = request . getHeader ( "Via" ) ; 

tempLanguage = request . getHeader ( "Accept -Language ") ; 
tempCharset = request . getHeader ( "Accept -Charset ") ; 
tempNetworklnfo = request .getHeader { "x-network- inf o" ) ; 



// COOKIES 

device . setCookies (request . getCookies ()); 
// ACCEPT 

device. setAccept (request. getHeader ("Accept") ) ,- 
// USER- AGENT 

device . setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent) ; 
// ACCEPT- LANGUAGE 

device . acceptLanguage = (tempLanguage == null) ? STR I NG_NO_VALUE : tempLanguage; 
// HOST 

device. host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 
// ACCEPT- ENCODING 

device . acceptEncoding = (tempEncoding == null) ? S T R I NG_NO_V ALUE : tempEncoding; 
// VIA 

device. via = (tempVia == null) ? STRING_NO_VALUE : tempVia; 
// ACCEPT -CHARSET 

device . acceptCharset = (tempCharset == null) ? S TR I NG_NO_V ALUE : tempCharset ; 
// NETWORK- INFO 

device .networklnfo = (tempNetworklnfo == null) ? S TR I NG__NO_V ALUE : tempNetworklnfo; 



} 



return device; 
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/ * * 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate * 

NO_VALUE constant . 

* 

* ©param guid unique device ID - may be null 
* 

* ©return a <code>Device</code> object representing an actual device 
* / 

public Device createDevice (String guid) { 

NokiaWAPDevice device = new NokiaWAPDevice (this) ; 



// NokiaWAPDevices have no GUID, so do not set 

// initialize properties to NO_VALUE 

device. setUserAgent ( S T R I NG_NO_V ALUE ) ; 

device. acceptLanguage = STRING_NO_VAliUE ; 

device, host = STRING__NO_VALUE ; 

device. acceptEncoding = STRING_NO_VALUE ; 
^ device, via = S TR I NG_NO_VALUE ; 

*f device. acceptCharset = STRING_NO_VAIAJE ; 

P device. networklnfo = STRING_NOJVALUE ; 

return device; 

? } 



3 // end 
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/ * * 

* @ (#) NokiaWAPDevice . java 
*/ 

package com. thinairapps . platform . device ; 

import javax. servlet .* ; 
import javax. servlet . http . * ; 

/ ** 

* ThinAirApps* abstraction for the Nokia family of WAP phones 

*' ■ , 

public class NokiaWAPDevice extends WAPDevice { 

// serialVersionUlD for compatability with previous versions 
static final long serialVersionUlD = 3955919879913874076L; 

protected String host, acceptLanguage, via, acceptEncoding , 
acceptCharset, networklnfo; 

/** 

* Constructs a new <code>NokiaWAPDevice</code> instance of the type represented by 

profile . 

* ©param profile <code>NokiaWAPDeviceProf ile</code> prototype for this device instance 
*/ 

3 NokiaWAPDevice (NokiaWAPDevice Prof ile profile) { 
^ super (profile) ; 

i3 ^ 

J * * 

^ * Retrieves the address of the host targeted by the request. 

=y * 

-J * ©return <code>String</code> host targeted by request 

n */ 

public String getHostO { return host; } 

/ ** 

l~ * Retrieves the language locale supported by the device. 

* 

.11 * ©return <code>String</code> language locale, if specified 
3 */ 

T public String get Accept Language () { return accept Language ; } 
/ ** 

* Retrieves the domain of the device's gateway. 
* 

* ©return <code>String</code> domain of request origin (gateway domain) 
*/ 

public String getGatewayO { return via; } 
/ * * 

* Retrieves a comma delimited list of file encodings supported by the device. 
* 

* ©return <code>String</code> list of file encodings acceptable by the device. 
*/ 

public String getAcceptEncoding ( ) { return acceptEncoding; } 
J * * 

* Retrieves the list of Character Set encodings supported by the device. 

* <p> 

* The returned <code>String</code> may be contain more than one Character Set value, 

* in which case the the values will be returned as a comma delimeted list. 
* 

* ©return <code>String</code> character set(s) supported by this device. 
*/ 

public String get AcceptCharset ( ) { return acceptCharset; } 
/** 
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* Retrieves information describing device's network connection. 

* <p> 

* Typical format: {data transport type }, {client IP address },{ secure connection flag} 
* 

* ©return <code>String</code> device's network information 
*/ 

public String getNetworklnf o ( ) { return networklnfo; } 
} // end 
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/** 

* @ {#) HTMLDevice Prof ile . java 
*/ 

package com. thinairapps .platform. device ; 

import javax . servlet .* ; 
import javax. servlet .http. * ; 

I ** 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> * 

factory for HTML devices 

* / 

public class HTMLDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -8489332563057202787L; 

/** name of this device profile */ 

public static final String NAME = "TA_HTML" ; 

/** content type accepted by all devices matching this profile */ 
protected static final String CONT ENT_T Y P E = "text /html " ; 

O /** 

p * Retrieves the <code>Class</code> of the <code>Device</code> object that this profile kf 

g creates. 

'"4 * ©return <code>Class</code> of the <code>HTMLDevice</code> instances that this profile 

S generates. 

Ll */ 

"~s public Class getDeviceClass ( ) { 

^ return new HTMLDevice (this) .getClass (); 

s } 

I™ / ** 

P * Retrieves the friendly name of this device type description. 
* 

Ji * ©return <code>String</code> A friendly name callers can use to refer to this <code> 
fj DeviceProf ile</code> 

*/ 

ri, public String getNameO { return NAME; } 
I * * 

* Determines whether the actual device making a request is of the type represented by 

* <code>HTMLDeviceProf ile</code> - 
* 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>boolean</code> true if the requesting device is of type <code> ^ 

HTMLDevice</code> / false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if ( super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent header 
HttpServletRequest request = (HttpServletRequest ) req; 
String accept = request .getHeader ("Accept") ; 
String userAgent = request . getHeader ( "User-Agent " ) ; 

return ( ((userAgent != null) && (userAgent . indexOf ( "Mozilla M ) >= 0) || 
(accept 1= null ) && (accept . indexOf (" text /html " ) >= 0) ) ); 

} 

return false ; 
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* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 
+ 

* ©param req the actual < code >ServletRequest< /code > received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest) req; 
HTMLDevice device = new HTMLDevice (this) ; 

//no sure way of obtaining unique id, so do not set device. GUID 

// declare temp values for device properties, to check for null 
String tempUser Agent , 

tempEncoding , 

tempHost, 

tempConnection, 

tempLanguage ; 

// initialize temps 

tempUserAgent = request . getHeader ( "User-Agent ") ; 
tempEncoding = request . getHeader ( "Accept -Encoding" ) ; 
tempHost = request .getHeader ( "Host" ) ; 
tempConnection = request . getHeader ( "Connection" ) ; 
tempLanguage = request .getHeader ( "Accept -Language" ) ; 



// COOKIES 

device. setCookies (request . getCookies ()); 
// ACCEPT 

device . setAccept ( request . getHeader { "Accept " ) ) ; 
// USER- AGENT 

device. setUserAgent ( (tempUserAgent == null) ? S TRI NG_NO_VALUE : tempUserAgent); 
// ACCEPT -LANGUAGE 

device. acceptLanguage = (tempLanguage == null) ? S TR I NG_NO__VALUE : tempLanguage; 
// HOST 

device. host = (tempHost — null) ? STRING_NO_VALUE : tempHost; 
// ACCEPT- ENCODING 

device. acceptEncoding = (tempEncoding == null) ? S TR I NG_NO_ VALUE : tempEncoding; 
// CONNECTION TYPE 

device. connect ionType = (tempConnection == null) ? STRING_NO_VALUE : tempConnection; 
return device; 



* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO VALUE constant . 
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* ©param guid unique device ID - may be null 
* 

* ©return a <code>Device</code> object representing an actual device 
public Device createDevice (String guid) { 

HTMLDevice device = new HTMLDevice ( this) ; 

// HTMLDevice s have no GUID, so do not set 

// initialize properties to NO_VALUE 
device . setUserAgent ( S T R I NG_NO_ VALUE ) ; 
device. acceptLanguage = STRING_NO_VALUE ; 
device. host = STRING_NO_VALUE ; 
device. acceptEncoding = STRING_NO_VALUE ; 
device .connect ionType = STRING_NO_VALUE ; 



} 

} // end 



return device 
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/** 

* @ (#) HTMLDevice . java 
*/ 

package com. thinairapps .plat form. device; 

import j avax . servlet . * ; 
import j avax. servlet .http. * ; 

j * * 

* ThinAirApps 1 s abstraction for all HTML devices 
* / 

public class HTMLDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = - 937006866328419345L; 

protected String acceptLanguage , acceptEncoding , connect ionType , host ; 

f * * 

* Constructs a new < code >HTMLDevi ce</ code > instance of the type represented by profile. 

* ©param profile < code >HTMLDeviceProfile< /code > prototype for this device instance 

*/ 

HTMLDevice (HTMLDevice Prof ile profile) { 
super (prof ile) ; 

O } 
*D /** 

i'U * Retrieves the content encoding type supported by this device. 

n * 

2 * ©return <code>String</code> content type supported by this device. 
*h> */ 

I J ■ public String getContentType ( ) { 

is return HTMLDevice Prof ile . CONTENT_TYPE ; 

H sj ^ 

: / ** 

m * Retrieves the language locale supported by the device. 

IS * 

?iM * ©return <code>String</code> language locale, if specified 
'3 */ 

f% public String getAcceptLanguage ( ) { return acceptLanguage; } 

= * Retrieves a comma delimited list of file encodings supported by the device. 
* 

* ©return <code>String</code> list of file encodings acceptable by the device. 
*/ 

public String getAcceptEncoding ( ) { return acceptEncoding; } 
/ * * 

* Retrieves the connection type for the request . 
* 

* ©return <code>String</code> connection type for the request (typically "Keep-Alive" or/ 

"Close" ) 

*/ 

public String getConnect ionType ( ) { return connect ionType ; } 
I * * 

* Retrieves the address of the host targeted by the request . 
* 

* ©return <code>String</code> host targeted by request 
*/ 

public String getHost ( ) { return host; } 
} // end 



C : \TASS\ . . \thinairapps\platf orm\device\HDMLDeviceProf ile . java 



/** 

* ©(#) HDMLDeviceProf ile . java 
*/ 

package com. thinairapps .platform. device; 

import j avax . servlet . * ; 
import j avax. servlet . http .* ; 

j * * 

* implements ThinAirApps 1 s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory for HDML devices 

*/ 

public class HDMLDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -1427190061023906748L; 

/** name of this device profile */ 

public static final String NAME = "TA_HDML" ; 

/** the content type expected by this device */ 
static final String CONT ENT_T Y P E = " text/x-hdml n ; 

S=S. 

s=J / * * 

p * Retrieves the < code >Class</ code > of the <code>Device</code> object that this profile 
Q creates . 

"s * 

Z * ©return <code>Class</code> of the <code>HDMLDevice</code> instances that this profile \l 
P generates, 

ij */ 

11 public Class getDeviceClass ( ) { 

'!z return new HDMLDevice (this) .getClass (); 

D } 

i /** 

* Retrieves the friendly name of this device type description. 

3 * 

S * ©return <code>String</code> A friendly name callers can use to refer to this <code> 
L[ DeviceProf ile</code> 

J */ 

public String getName ( ) { return NAME ; } 
I * * 

* Determines whether the actual device making a request is of the type represented by 

* <code>HDMLDeviceProf ile</code> . 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return < code >boolean< /code > true if the requesting device is of type <code> 

HDMLDevice</code> , false otherwise. 

*/ 

public boolean i sReque s t FromDevi ce (ServletRequest req) { 

if (super . isRequest FromDevi ce (req)) { 

// now cast request to HttpServletRequest to retrieve and check Accept header 
HttpServletRequest request = (HttpServletRequest ) req ,- 
String accept = (String) request .getHeader ("Accept") ; 

return ( (accept != null ) && (accept . indexOf ( CONTENT JTYPE) >= 0) ) ; 

} 

return false; 

} 
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/** 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 
* 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest ) req; 
HDMLDevice device = new HDMLDevice (this) ; 

// declare temp values for device properties, to check for null 
String tempGUID, 

tempUser Agent ; 

// initialize temps 

tempGUID = request .get Header ( "x- up- subno" ) ; 
tempUserAgent = request .getHeader ("User-Agent"); 

// **NEED TO VERIFY IF THIS IS ALWAYS UNIQUE** - gordogre 10/t8/2000 

if (tempGUID 1= null) device . setGUID ( HDMLDevice Prof ile .NAME + ":" + tempGUID ); 

3 // COOKIES 

p device . setCookies (request . getCookies ()); 

// ACCEPT 

jj device . setAccept ( request . getHeader ( "Accept K ) ) ,- 

J // USER- AGENT 

~i device . setUserAgent ( (tempUserAgent == null) ? STRlNG_NO_VALUE : tempUserAgent); 

return device ; 



/ ** 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NOJVALUE constant . 

* 

* ©param guid unique device ID - may be null 
* 

* ©return a <code >Device< /code > object representing an actual device 
*/ 

public Device createDevice (String guid) { 

HDMLDevice device = new HDMLDevice ( this) ; 

device . setGUID ( guid ); 

// initialize properties to NO_VALUE 
device . setUserAgent (STRING_NO_VALUE) ; 

return device; 



} // end 
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I * * 

* ©(#) HDMLDevice . java 
*/ 

package com. thinairapps .platform, device ,- 

import javax. servlet .* ; 
import javax. servlet . http .* ; 

/ * * 

* ThinAirApps ' s abstraction for all HDML devices 
*/ 

public class HDMLDevice extends HTTPDevice { 

// S erialVersionUID for compatability with previous versions 
static final long SerialVersionUID = 5976014305772814680L; 

* 

* Constructs a new < code >HDMLDevice</ code > instance of the type represented by profile. 

* ©param profile <code>HDMLDeviceProf ile</code> prototype for this device instance 

* / 

HDMLDevice (HDMLDevice Prof ile profile) { 
super (profile) ; 

} 

I * * 

O * Retrieves the content encoding type supported by this device. 

.f% * 

'.7Z * ©return <code>String</code> content type supported by this device. 

!*; */ 

'•4 public String getContentType ( ) { 
.1! return HDMLDe vice Prof ile . CONTENT_TYPE ; 

W } 

// end 
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/ * + 

* @ (#) GoWebRIMDeviceProf ile . java 
*/ 

package com. thinairapps .platform. device; 

import javax. servlet .* ; 
import javax. servlet . http .* ; 

/** 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> ^ 

factory 

* for GoWeb RIM devices 
*/ 

public class GoWebRIMDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 699491520536488575L; 

/** name of this device profile */ 

public static final String NAME = "TA_GOWEB_RIM" ; 

/** user-agent transmitted with every request coming from devices-matching this profile * 
*/ 

static final String US ER_AGENT = "Go. Web/1.1 (compatible; HandHTTP 1.1; Mozilla/1.0; ^ 

0 RIM950; compatible )"; 

^ /** content type accepted by all devices matching this profile */ 
static final String CONTENT__TYPE = " text/vnd. wap . wml " ; 

1 = 1 / * * 

l*i * Retrieves the <code>Class</code> of the <code>Device</code> object that this profile * 
creates . 

in * 

T * ©return <code>Class</code> of the <code>GoWebRIMDevice</code> instances that this 
profile generates . 

M */ 

U'i public Class getDeviceClass ( ) { 

i^i return new GoWebRIMDevice (this) .getClass () ; 

§ /** 

* Retrieves the friendly name of this device type description. 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 

DeviceProf ile</code> 

*/ 

public String getName ( ) { return NAME; } 



* Determines whether the actual device making a request is of the type represented by 

* <code>GoWebRIMDeviceProf ile</code> . 
* 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>boolean</code> true if the requesting device is of type <code> 

GoWebRIMDevice</code>, false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req) ) { 

// now cast request to HttpServletRequest to retrieve and test user-agent header 
HttpServletRequest request = (HttpServletRequest) req; 
String userAgent = (String) request . getHeader ("user-agent 11 ); 



\TASS\ . . \thinairapps\platform\device\GoWebRIMDeviceProf ile. java 



return ( (userAgent != null) (userAgent . indexOf ( "Go. Web" ) >= 0) && (userAgent. wr 

indexOf ( "RIM" ) >=0) ) ; 

// it's go web and it's rim, so return true. . . 

} 

return false; 



/ * * 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 
* 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest) req; 
GoWebRIMDevice device - new GoWebRIMDevice ( this) ; 

// declare temp values for device properties, to check for null 
String tempGUID, 

tempUserAgent , 

tempHost , 

tempReferer, 

tempLanguage ; 

// initialize temps 

tempGUID = request .getHeader ( "x-ga-subno" ) ; 
tempUserAgent = request .getHeader ("User-Agent") ; 
tempHost = request .getHeader ( "Host ") ,- 
tempReferer = request .getHeader ( "Ref erer" ) ; 
tempLanguage = request . getHeader ( "Accept -Language ,! ) ; 

// **NEED TO VERIFY IF THIS IS ALWAYS UNIQUE* * - gordogre 10/18/2000 

if (tempGUID != null) device . setGUID ( GoWebRIMDeviceProf ile .NAME + " : " + tempGUID ); 
// COOKIES 

device . setCookxes (request . getCookies ()); 
// ACCEPT 

device . setAccept ( request . getHeader ( "Accept " ) ) ; 
// USER -AGENT 

device . setUserAgent ( (tempUserAgent == null) ? S TR I NG_N0_ VALUE : tempUserAgent) ; 
// ACCEPT -LANGUAGE 

device. acceptLanguage = (tempLanguage == null) ? S T R I NG_NO_V ALUE : tempLanguage; 
// HOST 

device. host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 
// REFERER 

device .ref erer = (tempReferer == null) ? STRING_NO_VALUE : tempReferer; 
return device ; 



/ * ★ 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device. 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO VALUE constant. 
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* 

* ©param guid unique device ID - may be null 

* ©return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

GoWebRIMDevice device = new GoWebRIMDevice ( this ) ; 

device . setGUID( guid ),- 

// initialize properties to NO_VALUE 
device . setUserAgent (STRING_NO_VALUE) ; 
device . acceptLanguage = STRING__NO_VALUE ; 
device. host = STRING_NO_VALUE ; 
device, referer = STRING_NO_VAIjUE ; 

return device; 



} // end 
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/** 

* @(#)GoWebRIMDevice. java 
*/ 

package com . thinairapps . plat form . device ; 

import javax. servlet .* ; 
import javax. servlet .http .* ; 

/ * * 

* ThinAirApps 1 s abstraction for all RIM devices with GoWeb browsers 
*/ 

public class GoWebRIMDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 1155840689638109336L; 

protected String referer, host, acceptLanguage ,- 
/** 

* Constructs a new <code>GoWebRIMDevice</code> instance of the type represented by 

profile. 

* ©param profile <code>GoWebRIMDeviceProf ile</code> prototype for this device instance 
*/ 

GoWebRIMDevice (GoWebRIMDeviceProf ile profile) { 
super (profile) ; 

ij } 

\ y 

i'f% J * * 

l™\ * Retrieves the content encoding type supported by this device . 

=1= * ©return <code>String</code> content type supported by this device. 

y */ 

-.^\ public String getContentType () { 

,2 return GoWebRIMDeviceProf ile . CONTENTJTYPE ; 

m } 

Jsa / * * 

;2 * Retrieves the domain of the device's gateway. 

U - * 

O * ©return <code>String</code> domain of request origin (gateway domain) 

m */ 

™ public String getReferer() { return referer; } 

rt==i / * * 

* Retrieves the address of the host targeted by the request. 
* 

* ©return <code>String</code> host targeted by request 
*/ 

public String getHostO { return host; } 
/ * * 

* Retrieves the language locale supported by the device. 
* 

* ©return <code>String</code> language locale, if specified 
*/ 

public String getAcceptLanguage ( ) { return acceptLanguage; } 
} // end 
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/** 

* @ {#) GoWebPalmDeviceProf ile . java 
*/ 

package com . thinairapps . platform . device ; 

import javax. servlet .* ; 
import javax. servlet . http . * ; 

/ * * 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory for GoWeb Palm devices 

*/ 

public class GoWebPalmDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -5082728858823692866L; 

/** name of this device profile */ 

public static final String NAME = H TA_GOWEB_PALM" ; 

/** content type accepted by all devices matching this profile */ 
static final String CONTENT_TYPE = " text/vnd . wap . wml » ; 

□ I * * 

0 * Retrieves the <code>Class</code> of the <code>Device</code> object that this profile * 
S creates. . 

^ * ©return <code>Class</code> of the <code>GoWebPalmDevice</code> instances that this * 
C profile generates. 

\\ */ 

^ public Class getDeviceClass ( ) { return new GoWebPalmDevice (this) .getClass (.) ; } 
/ * * 

=s * Retrieves the friendly name of this device type description. 

P * ©return <code>String</code> A friendly name callers can use to refer to this <code> V 
DeviceProf ile</code> 

K */ 

IS public String getName ( ) { return NAME; } 
/ * * 

* Determines whether the actual device making a request is of the type represented by 

* <code>GoWebPalmDeviceProf ile</ code> . 
* 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>boolean</code> true if the requesting device is of type <code> 

GoWebPalmDevice </ code > , false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req) ) { 

// now cast request to HttpServlet Request to retrieve and test user-agent header 
HttpServletRequest request = (HttpServletRequest ) req; 
String userAgent - (String) request . getHeader ("user-agent"),- 

return (userAgent != null userAgent . indexOf ( "Go . Web" ) >= 0 && userAgent. ^ 
indexOf ( "Palm" ) >=0) ; 

// it's go web and it's palm, so return true... 

} 

return false; 
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/ * * 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 
* 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the ^ 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest ) req; 
GoWebPalmDevice device = new GoWebPalmDevice (this) ,- 

// declare temp values for device properties, to check for null 
String tempGUID, 

tempUserAgent , 

tempHost , 

tempReferer, 

tempLanguage ; 

// initialize temps 

tempGUID = request .getHeader ( "x-ga-subno" ) ; 

tempUserAgent = request . getHeader ("User-Agent"); 
_ tempHost = request .getHeader ( "Host " ) ; 

=J tempReferer = request . getHeader ( "Ref erer" ) ,- 

Q tempLanguage = request . getHeader ( "Accept -Language " ) ; 

^ // **NEED TO VERIFY IF THIS IS ALWAYS UNIQUE** - gordogre 10/18/2 000 

M if (tempGUID != null) device . setGUID ( GoWebPalmDeviceProf ile .NAME + " : " + tempGUID ); 

fj // COOKIES 

^ device . setCookies (request . getCookies ()); 

2 // ACCEPT 

device .setAccept (request .getHeader ( "Accept" ) ) ; 

^ // USER- AGENT 

j'l device . setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 

I // ACCEPT -LANGUAGE 

fj device . acceptLanguage = (tempLanguage == null) ? S TRI NG_NO_VALUE : tempLanguage ,- 

^ // HOST 

device. host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 
// REFERER 

device. ref erer = (tempReferer == null) ? S TR I NG_NO_V ALUE : tempReferer ; 
return device; 

' } 



/ * * 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate ^ 

NO_VALUE constant. 

* 

* ©param guid unique device ID - may be null 
* 

* ©return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

GoWebPalmDevice device = new GoWebPalmDevice (this) ; 
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device . setGUID ( guid ); 

// initialize properties to NO_VALUE 
device . setUser Agent (STRING_NO_VALUE) ; 
device. acceptLanguage = STRING_NO_VALUE ; 
device. host - STRING_NO_VALUE ; 
device. referer = STRING_NO_VALUE ; 

■ return device; 

} 



} // end 
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/** 

* @(#) GoWebPalmDevice . java 
*/ 

package com. thinairapps .platform. device; 

import javax. servlet .* ; 
import javax. servlet . http . * ; 

/* * 

* ThinAirApps ' s abstraction for all devices with GoWeb browsers on the Palm® platform 

*' • / 

public class GoWebPalmDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
. static final long serialVersionUID = 138821043664431198L; 

protected String referer, host, acceptLanguage ; 

/ * * 

* Constructs a new <code>GoWebPalmDevice</code> instance of the type represented by 

profile . 

* ©param profile <code>GoWebPalmDeviceProf ile</code> prototype for this device instance 
* / 

GoWebPalmDevice (GoWebPalmDeviceProf ile profile) { 
super (profile) ; 

i * * 

W * Retrieves the content encoding type supported by this device. 
* 

* ©return <code>String</code> content type supported by this device. 

ir; */ 

^ public String getContentType ( ) { 

' ■J return GoWebPalmDeviceProf ile . CONTENT_TYPE ; 

(0 > 

• I * * 

(3 * Retrieves the domain of the device's gateway. 

i^z, * 

I— * ©return <code>String</code> domain of request origin (gateway domain) 

Id. */ 

II j public String getRefererO { return referer; } 
\1 /** 

1 * Retrieves the address of the host targeted by the request . 

* 

* ©return <code>String</code> host targeted by request 
*/ 

public String getHostO { return host; } 
I * * 

* Retrieves the language locale supported by the device. 
★ 

* ©return <code>String</code> language locale, if specified 
*/ 

public String getAcceptLanguage ( ) { return acceptLanguage; } 
} // end 
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/** 

* @ (#) EricssonWAPDeviceProf ile . java 
*/ 

package com . thinairapps . platform . device ; 

import j avax . servlet .* ; 
import j avax. servlet .http. * ; 

j * * 

* Implements ThinAirApps • s standard <code>DeviceProf ile</code> and <code>Device</code> wr 

factory for Ericsson WAP phones. 

*/ 

public class EricssonWAPDeviceProf ile extends WAPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = - 915217898224689559L; 

/** name of this device profile */ 

public static final String NAME = "TA_ERICSSON_WAP" ; 
/ * * 

i~| * Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 
creates. 

;*f ★ 

iiO * ©return <code>Class</code> of the <code>EricssonWAPDevice</code> instances that this 
''-J profile generates. 

f */ 

z - : public Class getDeviceClass ( ) { 

^ return new EricssonWAPDevice (this) .getClass (); 

' j -k * 

\J * Retrieves the friendly name of this device type description. 

* 

•L" * ©return <code>String</code> A friendly name callers can use to refer to this <code> 
DeviceProf ile</code> 

m */ 

O public String getName ( ) { return NAME; } 
j * * 

* Determines whether the actual device making a request is of the type represented by 

* <code>EricssonWAPDeviceProf ile</code> . 
* 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return < code >bool ean< / code > true if the requesting device is of type <code> 

EricssonWAPDevice</code> , false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req) ) { 

// now cast request to HttpServletRequest to retrieve and test user-agent header 
HttpServletRequest request = (HttpServletRequest) req; 
String userAgent = (String) request . getHeader ("user-agent") ; 

return (userAgent !- null && 

( (userAgent . indexOf ( "Ericsson" ) >= 0) || 
(userAgent . indexOf ( "R3 80") >= 0) || 
(userAgent . indexOf ( "R320 " ) >= 0) || 
(userAgent . indexOf ( "888") >= 0) ) ) ; 

} 



return false; 
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} 



/** 

* Create a < code >Device</ code > instance with the same properties as the actual 

* physical device that generated this servlet request. 
* 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the * 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest ) req; 
EricssonWAPDevice device = new EricssonWAPDevice ( this) ; 

// FIXME FIXME FIXME 

// sgross 6/14/2000: is this unique? 

// this is at best the device's IP address, not reliably unique - gordogre 10/18/2000 
// also need to check for null to avoid null pointer exception on substring (5) 
String tempGUID = request .getHeader ("x-network-info") ; 

if (tempGUID 1= null) device . setGUID { NAME + " : "+ tempGUID . substring (5 ) ); 



i=| // declare temp values for device properties, to check for null 

String tempUserAgent , 
tempCharset, 
i J3 t empGa t e way , 

HJ tempLanguage ; 

// initialize temps 

tempUserAgent = request .getHeader ("user-agent"); 
•y tempCharset = request . getHeader ( "accept-charset " ) ; 

§g tempGateway = request .getHeader ( "via" ) ; 

tempLanguage = request .getHeader ( "accept -language " ) ; 

|3 // COOKIES 

ifi device . setCookies (request . getCookies ()); 

JL; // ACCEPT 

M device . setAccept (request .getHeader ( "Accept" ) ) ; 

13 // USER -AGENT 

l"2 device. setUserAgent ( (tempUserAgent == null) ? STRING__NO_VALUE : tempUserAgent); 

// CHAR-SET 

device .charset = (tempCharset == null) ? STRING_NO_VALUE : tempCharset; 
// GATEWAY 

device .gateway = (tempGateway == null) ? STR I NG_NO_VALUE : tempGateway ; 
// ACCEPT LANGUAGE 

device . language = (tempLanguage == null) ? STRING_NO_VALUE : tempLanguage; 
return device; 

} 



I * * 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device. 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO_VALUE constant. 

* 

* ©param guid unique device ID - may be null 
* 

* ©return a <code>Device</code> object representing an actual device 
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public Device createDevice (String guid) { 

Erics sonWAPDevice device - new EricssonWAPDevice ( this) ; 

device. setGUID{ guid ) ; 

// initialize properties to -NO_VALUE 
device. setUserAgent (STRING_NO_VALUE) ; 
device .charset = STRING_NO_VALUE ; 
device, gateway = 3TRING__NO_VALUE ; 
device, language = STRING_NO_VALUE ; 

return device ; 



} // end 
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/ ** 

* @ (#) EricssonWAPDevice . java 
*/ 

package com. thinairapps .platform, devices- 
import javax. servlet .* ; 
import javax. servlet .htt p. * ; 

/ * * 

* ThinAirApps' abstraction for the Ericcson family of WAP phones. 
*/ 

public class EricssonWAPDevice extends WAPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -7071206479514820282L; 

protected String host, charset, gateway, language; 

/ ** 

* Constructs a new <code>EricssonWapDevice</code> instance from this profile. 
* 

* ©param profile <code>EricssonWapDeviceProf ile</code> prototype used to create device. 
*/ 

EricssonWAPDevice (EricssonWAPDeviceProf ile profile) { 
super (prof ile) ; 

q ) 

H }z /** 

W * Retrieves the language locale supported by the device. 

'fcj * 

§£ * ©return <code>String</code> language locale supported by client device. 

in */ 

public String getLanguage ( ) { return language; } 

i'-fz I * * 

* Retrieves the list of Character Set encodings supported by the device. 
™ * <P> 

O * The returned <code>String</code> may be contain more than one Character Set value, 

jfl * in which case the the values will be returned as a comma delimeted list. 

\ I- * 

M * ©return <code>String</code> character set(s) supported by this device. 

in */ 

13 public String getCharsetO { return charset; } 
s ' ^ J * * 

* Retrieves a description of the WAP gateway used by this device. 
★ 

* ©return < code >String</ code > version of gateway used by this device 
*/ 

public String getGatewayO { return gateway; } 
} // end 
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/ * * 

* @ (#) AvantGoDeviceProf ile . java 
*/ 

package com. thinairapps .platform. device; 

import com. thinair .utils . * ; 

import javax. servlet .ServletRequest; 

import javax. servlet .http. HttpServletRequest; 

/** 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory for AvantGo devices 

*/ 

public class AvantGoDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 3548305456343669735L; 

/** name of this device profile */ 

public static final String NAME = "TA_AVANTGO" ; 

/** user-agent transmitted with every request coming from devices matching this profile 
*/ 

p static final String US ER_AGENT = "Mozilla/3 . 0 (compatible; AvantGo 3.2)"; 

■S /** content type accepted by all devices matching this profile */ 
static final String CONTENT_TYPE = " text /html " ; 

sis / * * 

^ * Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 
~4 creates. 
* 

* ©return <code>Class</code> of the <code>AvantGoDevice</code> instances that this 
profile generates. 

*/ 

public Class getDeviceClass ( ) { 

return new AvantGoDevice (this) .getClass () ; 

} 

/ * * 

* Retrieves the friendly name of this device type description. 
* 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 
DeviceProf ile</code> 

*/ 

public String getNameO { return NAME; } 
/ * * 

* Determines whether the actual device making a request is of the type represented by 

* <code>AvantGoDeviceProf ile</code> . 
* 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>boolean</code> true if the requesting device is of type <code> ^ 
AvantGoDevice</code> , false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

// check if device is an HTTP device 
if ( super . isRequestFromDevice (req) ) { 

// cast req to HttpServletRequest to retrieve and check User-Agent 
HttpServletRequest request = (HttpServletRequest) req; 
String userAgent = (String) request .getHeader ( "User- Agent ") ; 
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// cannot check for equivalence with US ER_ AGENT constant since other versions of «r 

AvantGo are possible - gordogre 
return (userAgent != null && us erAgent . indexOf ( "AvantGo" ) >=0) ; 
} else 

return false; 

} 



/ * * 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 
* 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 
* 

* ©return <code>Device</code> a device instance with properties set to describe the * 

requesting device. 

* / 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest ) req; 
AvantGoDevice device = new AvantGoDevice (this) ,- 



// declare temps for device properties for null checking 
String tempDeviceld, 

tempColorDepth , 

tempScreenSize, 

tempDeviceOS, 

tempUserlD, 

tempUserAgent , 

tempVersion, 

tempClientIP; 

// initialize temp properties 

tempDeviceld = request .getHeader { "X-AvantGo-Deviceld" ) ; 
tempColorDepth = request . getHeader ( "X- AvantGo -ColorDepth" ) ; 
tempScreenSize = request . getHeader ( "X-AvantGo-ScreenSize " ) ; 
tempDeviceOS = request . getHeader ("X-AvantGo-DeviceOS") ; 
tempUserlD = request . getHeader ( "X-AvantGo-Userld" ) ; 
tempUserAgent = request . getHeader ("User-Agent") ; 
tempVersion = request . getHeader ( "X- AvantGo- Verson" ) ; 
tempClientIP = request . getHeader ( "Client- ip" ) ; 



// the following 5 headers are base64 encoded, so we must first check for their 

presence before 
// decoding to avoid any null pointer exceptions 

// Device Id may no longer be valid (10/17 gordogre) 

if (tempDeviceld != null) device . setGUID ( NAME + " : " + Base64 . decode (tempDeviceld) ) 
// ACCEPT 

device . setAccept ( request . getHeader ( "Accept " ) ) ; 
// COOKIES 

device . setCookies (request . getCookies ()) ; 
// USER AGENT 

device . setUserAgent ((tempUserAgent == null) ? S TR I NG_NO_VALUE : tempUserAgent ); 



// COLOR DEPTH 

device. colorDepth - (tempColorDepth == null) ? STRING_NO_VALUE 
(tempColorDepth) ; 



Base64 . decode 



// SCREEN SIZE 

device. screenSize = (tempScreenSize == null) ? S T R I NG__NO_ V ALU E : Base64 . decode 
(tempScreenSize) ; 



// DEVICE OS 

device . deviceOS = (tempDeviceOS == null) ? STRING_N0_VALUE : Base64 . decode 



:0 "ft 
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(tempDeviceOS) ,- 
// USER ID 

device. userlD =(tempUserID == null) ? STRING_NO__VALUE : Base64 . decode ( tempUserlD) ; 



// VERSION 

//if AvantGo version 3.1 is being used, X-AvantGo- Vers ion will not be present - * 
gordogre 

device. version = (tempVersion == null) ? S TR I NG_NO_VALUE : tempVersion; 
// CLIENT IP 

// client IP may no longer be valid - gordogre 

device. clientIP = ( tempClientIP == null) ? STRING_NO_VALUE : tempClientIP; 

// SecureSync and onlineRequest headers only present when true, 
// so a value is always set (i.e. there is no " NO_VALUE " for these properties) 
device. secureSync = (request . getHeader ( "X-AvantGo-SecureSync" ) != null) ? true : * 
false ; 

device. onlineRequest = (request .getHeader ( "X-AvantGo-OnlineRequest " ) != null) ? true 
: false; 



return device; 



I * * 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconf igure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO_VALUE constant . 

* ©param guid unique device ID - may be null 
* 

* ©return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

AvantGoDevice device = new AvantGoDevice ( this) ; 
device. setGUID( guid ); 

// initialize all properties to NO_VALUE 
device . setUserAgent (STRING_NO_VALUE) ; 
device. colorDepth = STRING_NO_VALUE ; 
device . screenSize = STRING_NO_VALUE ; 
device. deviceOS = STRING_NO_VALUE ; 
device. userlD = S TR I NG_NO_VALUE ; 
- device. version = STRING_NO_VALUE ; 
device . clientIP = S TR I NG_NO_V ALUE ; 

return device; 



} // end 
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/** 

* ©(#) AvantGoDevice . java 
*/ 

package com. thinairapps .platform, device ; 

import javax. servlet .* ; 
import javax. servlet .http. * ; 

/ * * 

* ThinAirApps ' s abstraction for all devices with AvantGo browser version 3.2 

*' • / 

public class AvantGoDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -2822887137691798848L; 

protected String version, colorDepth, screenSize, deviceOS, userlD, clientIP; 
boolean onlineRequest , secureSync ; 

/ * * 

* Constructs a new <code>AvantGoDevice</code> instance of the type represented by 

profile . 

* ©param profile <code>AvantGoDeviceProf ile</code> prototype for this device instance 
*/ 

AvantGoDevice (AvantGoDeviceProf ile profile) { 
=i super (profile) ; 

Tf / * * 

y * Retrieves the content encoding type supported by this device. 
_1 ★ 

^ * ©return < code >St ring </ code > content type supported by this device 
=U * */ 

y public String getContentType ( ) { return AvantGoDeviceProf ile . CONTENTJTYPE ; } 
j * * 

* Retrieves the version of the AvantGo browser this device is running. 
^ * 

* ©return <code>String</code> client verison number 

*/ 

^ public String getVersionO { return version; } 

Tl 

~ / * * 

* Retrieves the color depth of the screen for the device. 

* ©return <code>String</code> color depth of device 
*/ 

public String getColorDepth ( ) { return colorDepth; } 
I * * 

* Retrieves the screen size of the device. 

* <p> 

* The returned value will be in the format "HxW" , where H is the height of the screen 

* in pixels, and W is the width of the screen in pixels. 
* 

* ©return <code>String</code> screen size of the device. 
*/ 

public String getScreenSize ( ) { return screenSize; } 
/ * * 

* Retrieves a description of the operating system running on the device. 
* 

* ©return <code>String</code> get device operating system 
*/ 

public String getOS ( ) { return deviceOS; } 
/ * * 

* Retrieves the AvantGo User Id for the user making the request. 

* ©return <code>String</code> AvantGo user id for person using this device 



# 
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*/ 

public String getUserldO { return- userlD; } 
/** . 

* Retrieves logical flag indicating an online request. 

* <p> 

* Devices using the AvantGo browser may be making an online request or an offline 

request . 

* When a request is an offline request, the AvantGo application caches the contents of s 

the requested 

* page for offline viewing on a device following a device synchronization. When a * 

request is an online 

* request, the user is interacting with the requested material in real time. 
* 

* ©return < code >boolean< /code > true if request is an online request, false if request \£ 
is an offline request. 

*/ 

public boolean isOnlineRequest ( ) { return onlineRequest ; } 
/ * * 

* Retrieves logical flag indicating that a request has been made via a secure connections 
* 

* ©return < code >boolean</ code > true if request is using a secure connection, false 
otherwise . 

*/ 

public boolean isSecureSync ( ) { return secureSync; } 
/ * * 

* Retrieves the IP address of the device. 

* <P> 

* This value may not be available for all requests, and may not be unique for all 

devices . 

* 

* ©return <code>String</code> ip address of client device */ 
public String getClientIP ( ) { return clientIP; } 



\% // end 



• 
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Getting Started 
the Hello world sample connector 

wireless SDK for ThinAir Server 



About this sample 



This is a very simple 'Hello world* connector that serves as an introduction to 
building custom applications using the the ThinAir connector API . The Hello 
world connector recognizes what device is contacting it and returns a simple 
message in the markup language for that device. This connector demonstrates: 

1. A simple use of the Thi nAi rServer ' s Device detection ability 

2. The use of different Tag libraries to render markup specific to each device 

3. The ability for a connector to process configuration file information. The 
Connector will append the value for SecretMessage in connector.ini to its 
output. 



jiequi rements 

rr 



ijhis sample requires the following SDK jars: 

* platform. jar 
\i * taglib.jar 
% \ * devices. jar 



^sample Files 

iThis sample consists of the following file tree: 
r: connector.ini - connector configuration file 
^ Helloworldconnector .class - compiled Java code 
& /src - Java source files 



Building the Sample 



compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your classpath. 

install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir Server's /Connectors subdirectory, given a name 
of your choice. 

Start the ThinAir Server, it will load the sample code and begin executing it. 



using the sample 



wait until the Thi nAi rServer has started and the Hello world Connector has been 
loaded and initialized. From your wireless device, enter the IP address listed 
as the value for Appli cationPath in connector.ini (your Thi nAi rServer IP 
address), followed by /samples/helloworld. For a machine with IP address 
111.222.12.34 this would be: 
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REAOME.txt 

http : //111 . 222 . 12 . 34/sampl es/hel 1 oworl d 
Follow the on-screen instructions. 



Last updated: 11.13.2000 
Copyright 1999, 2000 ThinAirApps inc. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//ThinAir Platform imports 

import com . thinairapps . platform. connector . * ; 
import com. thinairapps . platform . device . * ; 

//ThinAir Tag Libraries imports 
import com . thinairapps . tag . * ; 
import com . thinairapps . tag . wml . * ; 
import com . thinairapps . tag . html . * ; 
import com . thinairapps . tag . hdml . * ,- 

//Standard Java imports 
import java .util . * ; 
import java.io.*; 

/* . . 

* This is a sample Connector Application for use with ThinAir Server 

* It's purpose is to demonstrate how to write a simple connector, that 

* is able to use the device determination capabilites of the platform. 

— * 
3/ 

[public class HelloWorldConnector implements Connector 
% 

5 //private members for the application's user 
t private String SecretMessage = null ; 

~ j * * 

~j * init() is called by the ThinAirServer when the Connector is loaded. It provides 
0 * the Connector with resources it needs to interact with the ThinAirServer. 
* 

* ©param applicationName friendly name of the application 
J * ©param applicationPath URL path on which the server is hosting this Connector 
I? * ©param appProps properties loaded from the "connector . ini " file 

□ * ©param ca ConnectorAccess object to support profiles, sessions, and provider access 
5 * ©param applicationLog is used for Logging 
* */ 

J public void init (String applicationName, String applicationPath, Properties appProps, 
ConnectorAccess ca, ApplicationLog al) 

//load "SecretMessage" property from "connector . ini " file 
SecretMessage ~ appProps . getProperty { "SecretMessage" ) ,- 

} 



/**The handle method implements the core logic of a Connector. It takes an incoming 
request from a 

* particular device, and returns an appropriate response. This method is called whenever 

the server 

* receives a request from a type of device that the Connector indicates it supports, ^ 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of 

the Connector 

* to interpret the request and generate an appropriate response. 
* 

* The server will pass a Device object containing as much information as possible into \£ 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed \l 

information 

* on the capabilities of the particular device making the request. 
* 

* ©param props Device's request properties (i.e. http GET or POST arguments) 

* ©param device Device making the request 
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* ©param out OutputStream to write results to 
*/ 

public void handle (Properties props, Device device, OutputStream out) throws IOException 
{ 

// hold the return markup 
String result = null; 

// generate a simple message in the rendering format of the requesting device 

if (device instanceof WAPDevice) 
{ 

// WML parsing WAP device 

WMLTag Document deck = new WMLTagDocument ( ) ; 

com. thinairapps . tag .wml .Head head = new com. thinairapps . tag .wml .Head () ; 

com. thinairapps . tag.wml .Meta meta = new com. thinairapps . tag .wml .Meta * 

( "http-equiv" , " Cache - Cont rol " , "max-age=0 " ) ; 
head. addChild (meta) ; 
deck. addChild (head) ; 

com. thinairapps . tag.wml .DisplayCard card = new com . thinairapps . tag . wml . * 

DisplayCard ("HelloWorld", "Hello World"); 
card. buildCard( "Hello WAP User! "+SecretMessage, com. thinairapps . tag . wml . vr 

Paragraph. ALIGN_LEFT) ; 
deck. addChild (card) ; 



result = deck. render () ; 

} 

else if (device instanceof HDMLDevice) 
{ 

// HDML parsing HTTP device 

HDMLTagDocument deck = new HDMLTagDocument { ) ; 

com. thinairapps . tag .hdml .DisplayCard card = new com. thinairapps . tag . hdml . * 
DisplayCard ( ) ; 

card. addChild (new FormattedLine ( "Hello HDML User! " +SecretMessage , 

Format tedLine . LEFT) ) ; 
deck. addChild (card) ; 



result = deck. render () ; 
else 

{ 

// HTML parsing HTTP device 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps . tag. html .Head head = new com. thinairapps . tag . html . Head () ; 
com. thinairapps . tag. html .Meta meta = new com . thinairapps . tag . html .Meta 

( "name" , "PalmComputing Plat form" , "true" ) ; 
head. addChild (meta) ; 

com. thinairapps . tag .html .Title title = new com. thinairapps . tag . html .Titles 

("Hello World") ; 
head. addChild (title) ; 
doc . setHead (head) ; 

com. thinairapps . tag .html .Body body = new com . thinairapps . tag . html . Body () ; 
com. thinairapps . tag . html . Font font = new com . thinairapps . tag . html . Font 
( "geneva, arial " , 3); 

com . thinairapps . tag . html . Text text ,- 
if (device instanceof GoWebRIMDevice) 

text = new com. thinairapps . tag . html . Text ( "Hello GoWeb User! "+ ^ 
SecretMessage) ; 

else 

text = new com . thinairapps . tag . html . Text ( "Hello HTTP User! "+ ^ 
SecretMessage) ; 



font .addChild ( text ); 
body .addChild (font) ; 
doc . addChild (body) ; 



result = doc . render () ; 
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// write result to the output stream 
out .write (result. getBytesO ) ; 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing wr 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getName { ) method. 
* 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 

* ThinAir Server Developer Guide . 
* 

* ©return an array of Strings representing the friendly names of^ the devices this \l 

Connector supports . 

*/ 

public String [] getDevicesO 

{ 

String devices [] = 

UPWAPDeviceProf ile .NAME, PalmVIIDeviceProf ile .NAME, 
AvantGoDeviceProf ile . NAME , HDMLDeviceProf ile . NAME , 
GoWebRIMDeviceProf ile .NAME, HTMLDev ice Prof ile .NAME 

}; 

return devices; 




README . txt 



Devi ceDetecti ve 
a.k.a. inspector Gadget 
Sample Connector 
wireless SDK for ThinAir Server 



About this Sample 



The Devi ceDetecti ve sample connector: 

1. Demonstrates how to use the Device detection features of the ThinAir Server 

2. Showcases the Device objects and how they function in a working Connector 

3. Demonstrates the various Tag Libraries that render markup for different 
devices using a simple, uniform API 



with this connector you will be able to contact your ThinAi rServer 
with almost any wireless device, and have it automatically map your actual 
device to one of several built-in 'ThinAir Device Profiles' . The Device 
profiles will generate a Device object with the same properties as your 
actual device. Properties might include things like screen size, color depth, 
Mnd number of soft keys. The connector will return a page, in your device's 
ilawn markup language, listing the properties it detected along with the Device's 
.jjame. 

^Ror instructions on how to build your own Device Profiles, consult the 
jgeveloper's Guide. 



"$£equi rements 



s This sample requires the following SDK JARs: 
O * platform. jar 

* taglib.jar 
™ * devices. jar 



Sample Files 



This sample consists of the following file tree: 
connector.ini - connector configuration file 
Devi ceDetecti ve. jar - compiled Java code 
/src - Java source files 



Building the Sample 



Compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your CLASSPATH. 

install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir server's /Connectors subdirectory, given a name 
of your choice. 

Start the ThinAir server; it will load the sample code and begin executing it. 
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using the sample 



wait until the Thi nAi rserver has started and the Device Detective Connector has 
been loaded and initialized. From your wireless device, enter the IP address 
listed as the value for ApplicationPath in connector.ini (your Thi nAi rserver IP 
address), followed by /samples/device. For a machine with IP address 
111.222.12.34 this would be: 

http : //111 . 222 . 12 . 34/sampl es/devi ce 

Supported devices include: WAP phones, hdml phones, Palm Pilots, windows CE 
devices, desktop web browsers, and GO America/GO rim pagers, in order to build 
a Palm Query Application (PQA) that works with DeviceDetecti ve f you 
will need to understand and use M web Clipping" technology from Palm, web 
Clipping involves essentially creating html interfaces into your applications. 
For your convienence, an html file (deviceDetective.html) has been provided for 
this purpose. To find out more about creating PQAs and web Clipping 
technology, visit: http://www.palmos.com/dev/tech/webclipping/ 



Last updated: 11.13.2000 
Copyright 1999, 2000 ThinAirApps inc. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//ThinAir device library imports 

import com . thinairapps . platform . device . * ; 

//ThinAir Tag Libraries imports 
import com . thinairapps . tag . * ; 
import com . thinairapps . tag . wml . * ; 

//Standard Java imports 
import java.util.*; 



* This utility class renders output as WML for a variety of devices 
*/ 

class WMLRenderer 

{ 

ill / * * 

0 * Build a card with a welcome message that identifies the device to the user 
* 

;"1 * ©param deviceName String of Device name to be displayed 
5 * ©param keysf] String array of keys to be displayed 
p * ©param values [] String array of values to be displayed 
jj * 

'~ : * ©return String of formatted WML 
^ */ 

static String buildCard (String deviceName, String keys[], String values []) 
{ 

2 WMLTagDocument deck = new WMLTagDocument () ; 

5 Head head = new Head ( ) ; 

f* Meta meta = new Meta ( "http-equiv" , " Cache - Cont rol " , "max-age=0 " ) ; 

■J // this is to test cache control at the deck level... 

*h double rnd - Math . random () ; 

Meta meta2 = new Meta ( "name" , String .valueOf (rnd) , "max-age=0 " ) ; 

head. addChild (meta) ; 

head.addChild (meta2) ; 

deck. addChild (head) ; 

DisplayCard card = new DisplayCard ( "device" , "Inspector Gadget"); 
Paragraph p = new Paragraph (Paragraph . ALIGN_CENTER y Paragraph . MODE_NOWRAP ) ; 

StringBuffer sb = new StringBuf f er ( 56 ) ; 
sb . append (" <b>Welcome "); 
sb . append ( deviceName ) ; 
sb . append ( " </b> " ) ; 



p. addChild ( new Text { sb . toString {). trim () ) ) ; 
card. addChild (p) ; 

// print out the properties of the device 
// as key: value pairs 

p = new Paragraph ( Pa ragraph.AL I GN_LE FT, Paragraph . MODE_NOWRAP ) ; 
p. addChild (new Text ( "Device Properties : <br/ >")) ; 

Break br = new Break ( ) ; 

for (int i = 0; i < keys. length; i++) 

{ 



# • 
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p.addChild(new Text (keys [i] + ": " + valuesti])); 
p.addChild(br) ; 

} 

card.addChild(p) ; 

deck. addChild (card) ; 
return deck . render ( ) ; 

} 



/ * * 

* ©param device used to retrieve WAPdevice values 
* 

* ©return page welcoming a user of a basic WAP device 

*/ 

static String getMessage (WAPDevice device) 
{ 

String keys[] = new String [4]; 
keys[0] = "GUID"; 
keys[l] = "Protocol"; 
keys [2] = "Content -Type " ; 
keys [3] = "User-Agent"; 

String values [] = new String [4] ; 
values[0] = device .getGUID () ; 
values [1] = device .getProtocol () ; 
values[2] = device .getContentType () ; 
values[3] = device .getUserAgent () ; 

return buildCard( device .getProfile (). getName () , keys, values) ; 



/ * * 

* ©param device used to retrieve GoWebRimDevice values 
* 

* ©return page welcoming a user of a GoWeb device 
*/ 

static String getMessage (GoWebRIMDevice device) 

{ 

String keys[] = new String [4] ; 
keys[0] = "GUID"; 
keysfl] = "Protocol"; 
keys [2] = "Content -Type " ; 
keys [3] = "User-Agent"; 

String values [] - new String[4]; 
values[0] = device .getGUID () ; 
values [1] = device .getProtocol () ; 
values [2] = device . getContentType () ; 
values [3] = device . getUserAgent () ; 

return buildCard( device . getProfile (). getName () , keys, values); 



/ * * 

* ©parm device used to retrieve Unwired Planet WAP device values 
* 

* ©return page welcoming a user of a basic UP/WAP device 
*/ 

static String getMessage (UPWAPDevice device) 

{ 
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String keys [] = new String [14]; 

keys [0] = "GUID"; 

keys[l] = "Protocol"; 

keys [ 2 ] = " Content - Type " ; 

keys [3] = "User-Agent"; 

keys [ 4 ] = " Language " ; 

keys [5] = "Smart Dialing"; 

keys [6] = "Screen Depth"; 

keys [7] = "Color"; 

keys [8] = "Alert"; 

keys [9] = "Max PDU" ; 

keys [10] = "Soft Keys"; 

keys [11] = "Screen Chars" ; 

keys [12] = "Pixel Width"; 

keys [13] = "Pixel Height" ; 



String values [] = new String[14]; 
values [0] - device . getGUID () ; 
values[l] = device .getProtocol () ; 
values [2] = device . getContentType () ; 
values [3] = device . getUserAgent () ; 
values [4] = device . getLanguage () ; 

values[5] = String . valueOf (device . isSmartDialing ()) ; 
values[6] = String . valueOf (device .getScreenDepth ()) ; 
values [7] = String -valueOf (device . isColor ()) ; 
values [8] = String .valueOf (device . immediateAlert ()) ; 
values [9] = device .getMaxPDU( ) ; 

values[10] = String .valueOf (device . numSof tKeys 0) ; 
valuestll] = device .getScreenChars () ; 

values[12] = String .valueOf (device. getPixelWidth ( ) ) ; 
values [13] = String .valueOf (device .getPixelHeight ()) ; 

return buildCard( device .getProfile (). getName () , keys, values); 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//ThinAir device library imports 

import com. thinairapps .platform. device . * ; 

//ThinAir Tag Libraries imports 
import com. thinairapps . tag .* ; 
import com. thinairapps . tag .html . * ; 

//Standard Java imports 
import java.util.*; 

/* 

* This utility class renders output as HTML for a variety of devices 
*/ 

class HTMLRenderer { 
/* * 

* Build a card with a welcome message that identifies the device^ to the user 
* 

_ * ©param deviceName String of Device name to be displayed 
!□ * ©param keys[] String array of keys to be displayed 
?0 * ©param values [] String array of values to be displayed 

;ia * 

"'11 

: '~. * ©return String of formatted HTML 

'z */ 

static String buildCard (String deviceName, String keys [] , String values []) 



HTMLTagDocument doc = new HTMLTagDocument ( ) / 
Head head = new Head ( ) ; 

Meta meta = new MetaC'name", "PalmComputingPlatf orm" , "true") ; 
head . addChild (meta) ; 

head. addChild (new Title ( " Inspector Gadget")); 
doc . setHead (head) ; 
Body body = new Body ( ) ; 

Font font = new Font ( "geneva , arial " , 3 ) ; 

Center center = new Center (); 

StringBuffer sb = new StringBuf f er ( 56 ) ; 
sb . append ( " <B>Welcome " ) ; 
sb. append (deviceName) ; 
sb. append ( !, </B>" ) ; 

center . addChild ( new Text ( sb . toString (). trim () ) ); 

font .addChild (center) ; 
font .addChild (new Break ( ) ) ; 

// print out the properties of the device 
// as key: value pairs 

font . addChild (new Text ( "Device Properties : <BR> ")) ; 

Break br = new Break ( ) ; 

for (int i = 0; i < keys. length; i++) 

{ 

font . addChild (new Text (keys [i] + ": " + values[i])); 
f ont .addChild (br) ,- 

} 

body. addChild (font) ; 
doc . set Body (body) ; 
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return doc . render ( ) ; 



J * * 
* 

* ©parm device used to retrieve HTML device values 

* ©return String consisting of a page welcoming a user of a basic HTML device 
*/ 

static String getMessage (HTMLDevice device) 
{ ' 

String keys[] = new String [4] ; 
keys[0] « "GUID" ; 
keys[l] = "Protocol"; 
keys [2] = "Content -Type" ; 
keys [3] = "User-Agent " ,- 

String values [] = new String [4] ; 
valuestO] = device .getGUID () ; 
values[l] = device .getProtocol () ; 
values[2] = device . getContentType () ; 
values[3] = device . getUserAgent () ; 

return buildCard( device . getProfile (). getName () , keys, values); 



/ ** 
* 

* ©param device used to retrieve values from PalmVIIDevice 
* 

* ©return page welcoming a user" of a PalmVIIDevice device 
*/ 

static String getMessage (PalmVIIDevice device) 

{ 

String keys[] = new String [4] ; 
keys[0] = "GUID" ; 
keys[l] = "Protocol"; 
keys [2] = " Content- Type " ; 
keys [3] = "User-Agent"; 

String values [] = new String [4] ; 
valuestO] = device . getGUID () ; 
valuesfl] = device - get Protocol () ; 
values[2] = device . getContentType {) ; 
values[3] = device .getUserAgent () ; 

return buildCard( device .getProfile () .getName {) , keys, values); 

} 



/ * * 
* 

* ©param device used to retrieve values from AvantGoDevice 
* 

* ©return page welcoming user of AvantGoDevice 
*/ 

static String getMessage (AvantGoDevice device) 

{ 

String keys[] = new String [11] ; 
keys[0] = "GUID"; 
keys[l] = "Protocol"; 
keys [ 2 ] = " Content - Type " ; 



* 



C:\TASS\WirelessSDK\. . \ General \DeviceDetect ion\src\HTMLRenderer . j ava 



keys [3] = 

keys [4] j 

keys [5] = 

keys [6) = 

keys [7] = 

keys [ 8 ] : 

keys [9] = 
keys [10] 



"User-Agent " ; 
"Version" ; 
"Color Depth" , 
"Screen Size" , 
"OS " ; 
"UserlD" ; 
"Online " ; 
= "IP"; 



String values [] = new String [11]; 
values[0] = device . getGUID () ; 
values[l] = device . getProtocol () ; 
values [2] = device . getContentType () ; 
values [3] = device .getUserAgent () ; 
values [4] = device .getVersion () ; 
values[5] = device . getColorDepth () ; 
values [6] = device .getScreenSize () ; 
values [7] = device .getOS () ; 
values [8] = device .getUserld () ; 

values [9] = String .valueOf ( device - isOnlineRequest ( ) 
values[10] = device .getClientIP () ; 



return buildCard( device . getProfile (). getName () , keys, values^ ; 



fk /** 

^ * ©param device used to retrieve values from PocketlEDevice 
Si * 

E * ©return page welcoming user of PocketlEDevice 
\\ */ 

~ static String getMessage ( PocketlEDevice device) 

1 < 

U String keys [] = new String [7] ; 

keystO] = "GUID"; 

e - keys[l] = "Protocol"; 

~f keys [2] = 11 Content -Type " ; 

|1 keys [3] = "User-Agent"; 

3 keys [4] = "Color Depth"; 

™ keys [5] = "Screen Size"; 

keys [6] = "OS"; 

^ String values [] = new String [7] ; 

values [0] = device .getGUID () ; 

valuesEl] = device . getProtocol 0 ; 

values [2] = device .getContentType () ; 

values [3] = device .getUserAgent () ; 

values[4] = device .getColorDepth () ; 

values [5] = device .getScreenSize () ; 

values[6] = device .getOS {) ; 



return buildCard( device . getProfile () .getName () , keys, values); 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//ThinAir device library imports 

import com - thinairapps . platform . device . * ; 

//Thinair tag libraries imports 
import com. thinairapps . tag .* ; 
import com. thinairapps . tag .hdml . * ; 

//Standard Java imports 
import java.util.*; 

/ * * 

* This utility class renders output as HDML for a variety of devices 
*/ 

class HDMLRenderer 

{ 

/ * * 

* Build a card with a welcome message that identifies the device to the user 
* 

□ * ©param deviceName String of Device name to be displayed 
0 * ©param keys[] String array of keys to be displayed 

* ©param values [] String array of values to be displayed 

'''z * 

* ©return String of formatted HDML 

F */ 

-A static String buildCard (String deviceName, String keys[], String valuesU) 

y { 

S HDMLTagDocument deck = new HDMLTagDocument ( ) ; 

DisplayCard card = new DisplayCard () ; 

J § StringBuffer sb - new StringBuf f er ( 56 ) ; 

3 sb. append ( "Welcome "); 

fs sb. append (deviceName) ,- 

tl card. addText (new FormattedLine ( sb . toString ( ) . trim ( ) , FormattedLine . CENTER) ) ; 

?J card. addChild (new Break ( ) ) ; 



card.addChild(new FormattedLine ( "Device Properties : <BR> " , FormattedLine . LEFT) ) ; 

Break br = new Break ( ) ; 

for (int i ~ 0; i < keys. length; i++) 

card. addChild (new FormattedLine (keys [i] + " : " + values[i], FormattedLine . LEFT) ) ; 
card . addChild (br) ; 

} 

deck. addCard (card) ; 
return deck . render () ; 

} 



/ * ★ 

* Retrive values from HDML device and generates page 
* 

* ©parrn device used to retrieve HDML device values 
* 

* ©return String consisting of a page welcoming a user of a basic HDML device 
*/ 

static String getMessage (HDMLDevice device) 

{ 
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String keys[] = new String [4]; 
keys [03 = "GUID" ; 
keys [ 1 ] = " Protocol " ; 
keysE2] = " Content- Type " ; 
keys [3] = "User-Agent"; 

String values [] = new String [4]; 
values [0] = device. getGUID () ; 
values [1] = device .getProtocol () ; 
values [2] = device .getContentType () ; 
values[3] = device . getUserAgent () ; 

return buildCardt device . getProfile (). getName () , keys, values); 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Thinairapps Imports 

import com. thinairapps. plat form. connector . *; 
import com. thinairapps - platform . device . * ; 

//Standard Java Imports 
import j ava . net . * ; 
import j ava . io . * ; 
import java.util.*; 



/ * * 

* This Connector demonstrates ThinAir Server's facilities for detecting devices and * 

rendering 

* content conditionally using different Tag Libraries . 
*/ 

public class DeviceDetective implements Connector 

{ 

„ private Connect or Access connectorAccess; 

=f private String path; 

O 

Hi /**Called by the ThinAirServer when the Connector is loaded. It provides the Connector 
y. with 

p * resources it needs to interact with the ThinAirServer. 

s I * 

'Ji * For more information about the Connector interface, see the javadocs for the ThinAir 
^ Server API 

B * 

* ©param applicationName is a String derived from connector.ini. 
^ * ©param applicationPath is a String derived from connector.ini. 

fS * ©param connectorProps is a Properties list containing developer assigned 
fj connector-specific properties. 

3 * ©param connectorAccess is our access point to the services provided by ThinAir Server. 

* ©param applicationLog is used for logging 
U */ 

™* public void init (String name, String p, Properties iniProps, ConnectorAccess ca, \£ 
ApplicationLog al) 

{ 

connectorAccess = ca; 
path = path; 

} 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used )£ 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer \£ 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getName { ) method. 

* For more details about device detection and handling see the DeviceDetective sample * 

connector and the 

* ThinAir Server Developer Guide. 
* 

* ©return an array of Strings representing the friendly names of the devices this ^ 

Connector supports . 

*/ 

public String [] getDevicesO 
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String devices [] = 

AvantGoDeviceProf ile . NAME, 
GoWebPalmDeviceProf ile .NAME, 
GoWebRIMDeviceProf ile .NAME, 
HDMLDevice Pro file . NAME , 
HTMLDeviceProf ile .NAME, 
NokiaWAPDeviceProf ile .NAME, 
PalmVIIDeviceProf ile .NAME, 
Pocket IEDeviceProf ile .NAME , 
UPWAPDeviceProf ile .NAME, 
WAPDe vice Prof ile . NAME 

}; 

return devices ,- 



/**The handle method implements the core logic of a Connector. It takes an incoming 
request from a 

* particular device, and returns an appropriate response. This method is called whenever/ 

the server 

* receives a request from a type of device that the Connector indicates it supports, 
^ destined (as 

==? * indicated in the request URL) for a specific application. It is the responsibility of 
0 the Connector 

S * to interpret the request and generate an appropriate response. 
r ~' * 

S= * The server will pass a Device object containing as much information as possible into 
P this method. 

'd * The Connector can then utilize the particular Device class to determine more detailed *r 
'Jl information 

/r * on the capabilities of the particular device making the request. 
M * 

* ©param props a set of name value pairs corresponding to the HTTP request parameters / 

from the device. 

T. * ©param device a Device object created in the image of the actual device making this *r 
I s request. 

^ * ©param result a reference to the OutputStream that will be returned to the device. 

K */ 

public void handle (Properties reqProps, Device device, OutputStream out) throws / 
==J lOException 

= { 

// hold the return markup 
String result = null; 

try 

// determine which device is contacting the Connector and use a different 
// rendering class to generate output 
if (device instanceof HDMLDevice) 

result = HDMLRenderer .getMessage ( (HDMLDevice) device ); 

else if (device instanceof AvantGoDevice) 

result = HTMLRenderer . getMessage ( (AvantGoDevice) device ); 

else if (device instanceof GoWebPalmDevice) 

result = HTMLRenderer .getMessage ( (HTMLDevice) device ); 

else if (device instanceof PocketlEDevice) 

result = HTMLRenderer .getMessage ( (PocketlEDevice) device ); 

else if (device instanceof PalmVIIDevice) 

result = HTMLRenderer .getMessage ( (PalmVIIDevice) device ) ; 

else if (device instanceof HTMLDevice) 

result = HTMLRenderer .getMessage ( (HTMLDevice) device ) ; 
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else if (device instanceof GoWebRlMDevice) 

result = WMLRenderer .getMessage ( (GoWebRlMDevice) device ); 

else if (device instanceof NokiaWAPDevice) 

result = WMLRenderer .getMessage ( (NokiaWAPDevice) device ); 

else if (device instanceof UPWAPDevice) 

result = WMLRenderer .getMessage ( (UPWAPDevice) device ) ,- 

else if (device instanceof WAPDevice) 

result = WMLRenderer .getMessage ( (WAPDevice) device ) ,- 

else 

result ■= "ERROR: Device " +device . getClass ( ) + " not supported."; 



catch (Exception e) 

{ 



e .printStackTrace ( ) ; 



result = "ERROR: "+e .getMessage () ; 

} 



out. write ( result . getBytes ( ) ); 



Setup 



Inspector Gadget 



Page 1 of 1 



Press GO and I will discover your device automatically: 




file://C:\T ASS\WirelessSDK\Samples\GeneraI\DeviceDetection\deviceDetective.html 2/15/2001 
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Database Connector Sample Connector 
Wireless SDK for ThinAir server 



About this Sample 



This sample connector demonstrates the ability to connect to a Database using a 
ODBC connection, retrieve data and display it on either a HTML or WML device. 



Requi rements 



This sample requires the following SDK jars: 

* platform. jar 

* taglib.jar 

* device. jar 

~n 

^Sample Files 

^This sample consists of the following file tree: 
["71 connector.ini - connector configuration file 
'-■J DBConnector .class - compiled Java code 
IJS /src - java source file - DBconnector . java 



building the sample 



"^Compile the sample code using the Java compiler of your choice. Make sure to 
Uappend the required jar files above into your CLASSPATH. 

install the compiled sample code and connector.ini configuration file into a 
Subdirectory of the ThinAir server's /connectors subdirectory, given a name 
of your choice. 

Create a ODBC dsn name of "Northwi nd" pointing to the Microsoft Access 
Northwind Database. 

Start the ThinAir server, it will load the sample code and begin executing it. 



using the sample 

wait until the Thi nAi rServer has started and the DBconnector has 
been loaded and initialized. From your wireless wml device, or web browser, 
enter the IP address listed as the value for Appli cationPath in connector.ini 
(your Thi nAi rServer IP address), followed by /sampl es/DBconnector . For a 
machine with IP address 111.222.12.34 this would be: 

http : //111 . 222 . 12 . 34/sampl es/DBconnecto r 

Follow the on-screen instructions. 



Last updated: 11.13.2000 

Page 1 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//ThinAir Platform import 

import com. thinairapps . platform . connector . * ,- 
import com. thinairapps. plat form. device. * ; 

//ThinAir Tag Libraries import 
import com . thinairapps . tag . html . * ; 
import com . thinairapps . tag . wml . * ; 

import j ava . io . * ; 
import java.util . * ; 
import j ava . sql . * ; 



/* . . 

* This is a sample Connector Application for use with ThinAir Server 1.2. Its 

* purpose is to demonstrate a simple connection to a database utilizing the 

* ThinAir Connector API. A ODBC connection to the Microsoft Access Northwind 
Database needs to be established with the DSN name of "Northwind" . 

3/ 

public class DBconnector implements Connector 



private String appname; 

private Connect or Access connectaccess ; 



/ * * 

* initO is called by the ThinAirServer when the Connector is loaded. It 

* provides the Connector with resources it needs to interact with the 

* ThinAir Server. For more information about the Connector interface, see 

* the javadocs for the ThinAir Server API 
* 

* ©param applicationName is a String derived from connector.ini. 

* ©param applicationPath is a String derived from connector.ini. 

* ©param connectorProps is a Properties list containing developer assigned 

* connector- specif ic properties. 

* ©param connectorAccess is our access point to the services provided by 

* ThinAir Server. 

* ©param applicationLog is used for logging. It is not utilized in this 

* sample 
*/ 

public void init (String name, String p, Properties iniProps, ConnectorAccess ca, 
ApplicationLog al) 

//Since we do not use any of the above in this sample, this area is blank 

} 



j * * 

* getDevicesO is called once by the ThinAir Server during start-up. It 

* allows a Connector to indicate the types of devices it supports. 

* getDevicesO returns an array containing the names of all DeviceProf iles ' 

* supported by this Connector. These names are the friendly names used to 

* uniquely identify every DeviceProf ile . To get the friendly name of a 

* particular device, refer to the ThinAir Server Developer Guide or call 

* DeviceProf ile ' s getName ( ) method. 
* 

* For more details about device detection and handling see the Device 

* Detective sample Connector and the ThinAir Server Developer Guide. 
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* ©return an array of Strings representing the friendly names of the 

* devices this Connector supports. 
*/ 

public String [] getDevicesO 

String [] devices = { " TA_WAP " , " TA_HTML " } ; 
return devices; 

} 



/** 

* The handle method implements the core logic of a Connector. It takes an 

* incoming request from a particular device, and returns an appropriate 

* response. This method is called whenever the server receives a request 

* from a type of device that the Connector indicates it supports, destined 

* (as indicated in the request URL) for a specific application. It is the 

* responsibility of the Connector to interpret the request and generate an 

* appropriate response. 

* The server will pass a Device object containing as much information as 

* possible into this method. The Connector can then utilize the particular 

* Device class to determine more detailed information on the capabilities 

* of the particular device making the request. 
* 

* ©param props a set of name value pairs corresponding to the HTTP request 

* parameters from the device. 

* ©param device a Device object created in the image of the actual device 

* making this request . 

* ©param result a reference to the OutputStream that will be returned to 

* the device. 
*/ 

public void handle (Properties reqProps, Device device, OutputStream out) throws 
IOException 



//Find out what action the user is trying to perform 
String action = reqProps .getProperty ( "action" ) ; 
String output - null ; 
String message = null; 

//If this is the first time entry , then action would be null. 
//We then produce a welcome screen 
if (action null) 

{ 

//Detect what type of device the user has 

if (device instanceof WAPDevice) 

{ 

//Since this is a WAP device, generate WML. Below is the WML and how the WML tag*" 
libraries are used to generate it 

//<wmlxcard id="main" title= "Welcome" ><p>Welcome to the Database Sample App<br/>*f 

Please choose from the f ollowing . . . </br> 
//<anchor> <go href = " . /DBconnec tor?act ion= 1 " >Select statement l</gox/anchorx/wr 

brxanchorxgo href = " . /DBconnector?action=2 " >Select statement 2</gox/ *r 

anchor> 
//</px/cardx/wml> 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( "Welcome ") ; 

com. thinairapps . tag .wml . Paragraph p = new com . thinairapps . tag . wml . Paragraph (com. \i 
thinairapps . tag .wml . Paragraph . ALIGN_LEFT , com. thinairapps . tag .wml . Paragraph, 
MODE_WRAP ) ; 

p.addChild(new com . thinairapps . tag . wml . Text (" <b>Welcome to the Database Sample *f 
App</b>" ) ) ; 

p.addChild(new com . thinairapps . tag . wml . Break () ) ; 

p.addChild (new com . thinairapps . tag . wml . Text ( "Please choose from the following * 
...")); 
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p .addChild (new com. thinairapps . tag . wml . Break ( ) ) ; 

com. thinairapps . tag . wml .Go go = new com . thinairapps . tag . wml . Go { " . /DBconnector? * 
actional", true, com . thinairapps . tag . wml . Go . METHOD_GET) ; 

com. thinairapps . tag . wml .Anchor anchor - new com. thinairapps . tag .wml .Anchor (go, new * 
com. thinairapps . tag .wml .Text ( "Query 1" ) ) ; 

p .addChild (anchor) ; 

p .addChild (new com . thinairapps . tag . wml . Break ( ) ) ; 

go = new com. thinairapps . tag .wml .Go ( " . /DBconnector?action=2 " , true, Go. 
METHOD_GET) ; 

anchor = new com. thinairapps . tag . wml . Anchor (go, new com . thinairapps . tag . wml . Text 
("Query 2") ) ; 

p . addChild (anchor) ; 

p . addChild (new com. thinairapps . tag . wml . Break () ) ; 
card . addParagraph ( p ) ; 

deck. addCard( card) ; 

//render the card and then output 
out .write (deck. render ( ) .getBytes ( ) ) ; 

} 

else 

S //If it is not WML, then it can only be HTML. Below is the actual HTML and how * 

% the HTML tag libraries are used to generate it 

w 

y //<htmlxhead>Welcome to the Database Sample App</headxbodyxp>Please choose 

p from the f ollowing . . . </p> 

ff s l //<a href = " . /DBConnector?action=l " >Select statement l</axa href = " . / 

^ DBConnector?action=2 " >Select statement 2</a> 

SI //</bodyx/html> 

fl HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps. tag. html. Head head = new com. thinairapps . tag . html . Head () ; 

head. addChild (new com. thinairapps . tag . html .Text ( "Welcome to the Database Sample 
^ App")); 
\\ doc . setHead (head) ; 

2 Body mBody = new Body { ) ; 

3 com. thinairapps . tag .html . Paragraph para = new com. thinairapps . tag .html . Paragraph * 

1 <> ; 

par a. addChild (new com. thinairapps . tag .html .Text ( "Please choose from the following^ 
...")); 

mBody . addChild (para) ; 

com. thinairapps . tag .html .Anchor anl = new com. thinairapps . tag . html .Anchor ( "Select * 
statement 1", " . /DBconnector?action=l " , new com. thinairapps . tag . html . Text * 
("Query 1") ) ; 

mBody .addChild (anl) ; 

mBody .addChild (new com . thinairapps . tag . html . Break () ) ; 

com. thinairapps . tag .html .Anchor an2 = new com . thinairapps . tag . html .Anchor ( "Select * 
statement 2", " . /DBconnector?action=2 " , new com . thinairapps . tag . html . Text * 
("Query 2") ) ; 

mBody- addChild (an2) ; 

mBody . addChild (new com . thinairapps . tag . html . Break () ) ; 
doc . set Body (mBody) ,- 



//render the card and then output 
out .write (doc . render { ) .getBytes ( ) ) ; 
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else 

//else, the action parameter is populated 

//Open the database connection t 

{ 

Connection con = null; 
Statement stmt = null; 

ResultSet result = null; 
ResultSetMetaData resultmeta; 
String headerl = null; 
String header2 = null; 
//open connection to DB 
try 

{ 

//Using the Microsoft JDBC ODBC Driver 

Class . f orName ( "com.ms . jdbc . odbc . JdbcOdbcDriver " ) ; 

//here's the sun driver 

//Class . f orName ( " sun . j dbc . odbc . JdbcOdbcDriver " ) ; 

} 

catch (Exception e) 

System.out .printlnC 1 Failed to load JDBC/ODBC driver."); 
return; 

□ } 

;3 //Be sure to establish a ODBC connection with Northwind as the DSN 

J^* String URL = " jdbc : odbc : Northwind" ; 

.Tl //there is no username or password 

\U String username = ""; 

I '~\ String password = " " ; 

" try 

is { 

. //try to establish connection 

Jsa con = DriverManager . getConnection (URL, username , password) ; 

ill //create a Statment 

*2 , stmt = con. createStatement ( ) ; 

m ) 

catch (Exception e) 
i-i System, err .println( "problems connecting to "+ URL); 

} 



String query = null; 

//Determine which select statement to use 
if (action . equals ( M 1 " ) ) 

query = "Select CompanyName , Phone from Shippers;"; 

else 

//action equals 2 so use second SQL 

query = "SELECT DISTINCTROW TOP 10 Products . ProductName , Products . UnitPrice 
FROM Products ORDER BY Product s . UnitPrice DESC;"; 



try 

{ 

//execute the query 

result = stmt . executeQuery (query) ; 

//get metadata 

resultmeta = result .getMetaData () ; 

//get the first column label, the return is limited to 2 columns due to the 
SQL query 

headerl = resultmeta . getColumnLabel ( 1 ) ; 
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//get the second column label 

header2 = resultmeta .getColumnLabel (2 ) ; 

} 

catch (Exception e) 

String emesg = e . getMessage 0 ; 
System. err . println (emesg) ; 

} 



//retrieve data, generate page depending on client 
if (device instanceof WAPDevice) 

{ 

//Generate result page, using the metadata above to generate the header 
columns 

//<wml><card id="result" title= "Results" xpxtable columns= "2 " xtrxtd> 

Header</tdxtd>Header2</tdx/tr> 
//<trxtd>Details</tdxtdxDetails2</tdx/tr>. . . . </tablex/p></cardx/wml x 

> 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( "Results" ) ; 

com. thinairapps . tag .wml . Paragraph p = new com. thinairapps . tag . wml . 

Paragraph (com. thinairapps . tag .wml . Paragraph. ALIGN_LEFT, com. 

thinairapps . tag .wml . Paragraph . MODE_WRAP ) ; 
p . addChild (new com. thinairapps . tag . wml . Text ( " <b>Resul ts</b> " ) ) ; 
p. addChild (new com. thinairapps . tag . wml . Break ( ) ) ; 

com. thinairapps. tag. wml .Table resultTable = new com. thinairapps . tag .wml . y? 

Table ( "Results" , com. thinairapps . tag .wml . Table . ALIGN_CENTER, 2) ; 
com. thinairapps . tag. wml .TableRow tr = new com. thinairapps . tag .wml . * 

TableRow ( ) ; 

com. thinairapps . tag .wml .TableCell tcl = new com. thinairapps . tag .wml . 
TableCell () ; 

com. thinairapps . tag. wml .TableCell tc2 = new com. thinairapps . tag .wml . 
TableCell () ; 

tcl .addChild (new com. thinairapps . tag .wml .Text (headerl) ) ; 

tc2 .addChild (new com. thinairapps . tag .wml .Text (header2 ) ) ; 

tr. addChild (tcl) ; 

tr. addChild (tc2) ; 

resultTable. addChild (tr) ; 

try 

{ 

String detain, ■ 
String detail2; 

//now go through the result set and render the table until result is 

empty 
while (result .next ( ) ) 
{ 

detaill = result .getString ( 1) ,- 

detail2 = result .getString (2 ) ; 

tr = new com . thinairapps . tag . wml . TableRow () ,- 

tcl = new com. thinairapps . tag .wml .TableCell () ; 

tc2 = new com. thinairapps . tag .wml . TableCell () ; 

tcl .addChild (new com. thinairapps . tag .wml .Text (detaill) ) ; 

tc2 . addChild (new com. thinairapps . tag .wml .Text (detail2) ) ; 

tr .addChild(tcl) ; 

tr .addChild(tc2) ; 

re suit Table. addChild (tr) ; 

} 

} 

catch (Exception e) 

{ 

String emesg = e . getMessage () ; 
System, err .println (emesg) ,- 

> 
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p . addChild (resultTable) ; 
card.addParagraph (p) ; 
deck. addCard (card) ; 

//render the deck and output the result 
out .write (deck. render ( ) .getBytes ( ) ) ; 

} 

else 

if (device instanceof HTMLDevice) 

{ 

//Below is the result page, first the HTML source , then how the 

HTML Tag libraries are used 
//<htmlxhead>Here ' s the result</head><body><table><tr><td> 

Headerl</td><td>Header2</tdx/tr> 
//<trxtd>detaill</tdxtd>detail2</td></tr> . . . . </table> 
/ / < /body > < /html > 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps .tag -html .Head head = new com.thinairapps.tag.html. 
Head ( ) ; 

head. addChild (new com. thinairapps . tag . html . Text ( "Results " ) ) ; 
doc . setHead (head) ; 
IsJ Body mainbody = new Body() ; 

«0 com . thinairapps . tag . html . Paragraph mainpara - new com. thinairapps . tag 

i ?% . html . Paragraph ( ) ; 

y com. thinairapps . tag. html .Table resulttable = new com. thinairapps . tag . 

s p html .Table (1) ; 

com. thinairapps. tag. html. TableRow tr = new com.thinairapps.tag.html. * 
l]^ TableRow ( ) ,- 

^ com. thinairapps. tag. html. TableCell tcl = new com . thinairapps . tag . html 

ifi .TableCell () ; 

com. thinairapps . tag. html .TableCell tc2 = new com. thinairapps . tag . html 
j«* .TableCell () ; 

*2 tcl . addChild (new com. thinairapps . tag . html . Text (headerl )) ; 

111 tc2 .addChild (new com. thinairapps . tag . html . Text (header2 )) ; 

O tr .addChild (tcl) ; 

tr. addChild (tc2) ; 

resulttable .addChild (tr) ; 
M try 

String detain ; 
String detail2; 

//run through the result set and render the table, until result 

is empty 
while (result .next ( ) ) 

{ 

detain = result .getString ( 1 ) ; 
detail2 = result .getString (2 ) ; 

tr = new com. thinairapps . tag . html . TableRow () ; 

tcl = new com. thinairapps . tag .html . TableCell {) ; 

tc2 = new com. thinairapps . tag .html . TableCell () ; 

tcl . addChild (new com . thinairapps . tag .html .Text (detain) ) ; 

tc2 . addChild (new com. thinairapps . tag .html .Text (detail2) ) ; 

tr .addChild(tcl) ; 

tr. addChild (tc2) ; 

resulttable. addChild (tr) ; 

} 

} 

catch (Exception e) 

{ 

String emesg = e . getMessage ( ) ; 
System. err . print In (emesg) ; 

} 
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mainpara . addChild ( resulttable) ; 
mainbody . addChild (mainpara) ; 
doc . setBody (mainbody) ; 

//render the document and output the result 
out .write (doc . render { ) .getBytes ( ) ) ; 

} 

//close the result, stmt and con objects 

try 

{ 

result .close ( ) ; 
stmt . close ( ) ; 
con. close ( ) ; 

} 

catch (Exception e) 

{ 

System. err ,println( "Error on closing"); 

} 

} 

} 

} 
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//Core ThinAir Server API functionality 
import com. thinairapps .platform. provider . * ; 
import com. thinairapps .platform, exception .* ,- 

//Core Java API 
import j ava . ut i 1 . * ; 

public class TestProviderContext extends StoreProviderContext 
^ public static final short RESULT = 888; 
// Version information 

protected static final String VERSION = "1.0"; 

protected static String APP_NAME = "TestProvider " ; 

protected static final String MANU F_NAME = "ThinAirApps" ; 
protected static final String MANUF_CONT = "www . ThinAirApps . com" 
protected static final String BUILD = "1" ; 

protected static final Date AP P_RE LEAS ED = new Date (); 

public St ore Provide rType getType ( ) 

{ 

//Not used by this Provider 
return null ; 

} 

M public StoreProviderlnf o getlnfo {) 

s'o { 

.rz return new StoreProviderlnf o ( MANUF_NAME , 

MANUF_CONT , 
APP__NAME, 

_g VERSION , 

I; ; BUILD , 

AP P_RE LEAS ED ) ; 

y } 

1 j|l 
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import com . thinairapps . platform - connector . * ; 
import com. thinairapps . platform . provider . * ; 
import com. thinairapps .platform. device . * ; 

import com . thinairapps . tag . html . * ; 
import com . thinairapps . tag . wml . * ; 

import j ava . io . * ; 
import java.util.*; 
import j ava . sql . * ; 

public class TestProviderConnector implements Connector 
{ 

private ConnectorAccess myCA; 
private String connectorName ; 
private String path; 

public void init (String name, String path, Properties iniProps, ConnectorAccess ca, com. 
thinairapps . platform . connector . ApplicationLog appLog) 

connectorName = name; 
myCA = ca; 
this. path - path; 



ft 



public String [] getDevicesO 

String [] devices = { " TA_WAP " , " TA_HTML " } ; 
return devices ; 

public void handle (Properties reqProps, Device device, OutputStream out) throws 
IOException 

//Find out what action the user is trying to perform 
String action = reqProps .get Property ( "action" ) ; 
String output = null; 
String message = null; 

String sessionID = null; 

//If this is the first time entry , then action would be null. 
//We then produce a welcome screen 
if (action == null) 

{ 

//Detect what type of device the user has 
if (device instanceof WAPDevice) 
{ 

//Since this is a WAP device, generate WML. Below is the WML and how the WML tagwr 
libraries are used to generate it 

//<wml><card id= "main" title= "Welcome" ><p>Welcome to the Database Sample App<br/>tf 

Please choose from the f ollowing . . . </br> 
//<anchor> <go href = " . /DBconnector?act ion=l " >Select statement l</gox/anchorx/ 
brxanchorxgo href = " . /DBconnector ?ac t ion=2 " >Select statement 2</go></ * 
anchor> 
//</p></ card></wml> 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( "Welcome" ) ; 

com. thinairapps . tag .wml . Paragraph p = new com . thinairapps . tag . wml . Paragraph (com . 

thinairapps . tag . wml . Paragraph . AL I GN_LE FT , com . thinairapps . tag . wml . Paragraph . * 
MODE_WRAP) ; 

p.addChild(new com. thinairapps . tag . wml . Text ( " <b>Welcome to the Database Sample * 
App</b>" ) ) ; 

p.addChild(new com . thinairapps . tag . wml . Break ( ) ) ; 

p.addChild(new com . thinairapps . tag . wml . Text (" Please choose from the following 
...")); 
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p .addChild (new com. thinairapps . tag . wml . Break {) ) ; 

com. thinairapps . tag .wml .Go go = new com. thinairapps . tag . wml . Go ( " . /DBconnector? 

action=l n , true, com . thinairapps . tag . wml . Go . METHOD_GET) ; 
com. thinairapps . tag .wml .Anchor anchor = new com . thinairapps . tag . wml .Anchor (go, new*f 

com . thinairapps . tag . wml . Text ( "Query 1 " ) ) ; 

p. addChild (anchor) ,- 

p . addChild (new com. thinairapps . tag .wml .Break () ) ; 

go = new com . thinairapps . tag . wml . Go (". /DBconnector?action=2 " , true, Go. 
ME THOD_GE T ) ; 

anchor = new com. thinairapps . tag .wml .Anchor (go, new com . thinairapps . tag .wml . Text * 
("Query 2") ) ; 



p . addChild (anchor) ,- 

p .addChild (new com. thinairapps . tag .wml .Break () ) ; 
card.addParagraph(p) ; 

deck. addCard (card) ,- 



//render the card and then output 
out .write (deck. render () .getBytes 0) ; 

} 

else 

{ 

//If it is not WML, then it can only be HTML. Below is the actual HTML and how 
the HTML tag libraries are used to generate it 

//<htmlxhead>Welcome to the Database Sample App</headxbodyxp>Please choose 

from the f ollowing . . . </p> 
//<a href = " . /DBConnector?action=l " >Select statement l</axa href = " ./ 

DBConnector?action=2 " >Select statement 2</a> 
/ / < /body >< /html > 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps . tag .html .Head head = new com. thinairapps . tag . html .Head () ; 

head. addChild (new com. thinairapps . tag . html . Text ( "Welcome to the Database Sample 

App") ) ; 
doc . setHead (head) ; 

Body mBody = new Body ( ) ; 

com. thinairapps . tag -html . Paragraph para = new com . thinairapps . tag . html . Paragraph 
() ; 

para .addChild (new com. thinairapps . tag . html . Text (" Please choose from the following* 1 
...")); 

mBody .addChild (para) ; 

com. thinairapps . tag .html .Anchor anl = new com. thinairapps . tag .html .Anchor ( "Select 
statement 1", path + " ?action=l " , new com . thinairapps . tag . html . Text ( "Query * 
1") ) ; 



mBody . addChild (anl ) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) ) ; 

com. thinairapps . tag . html .Anchor an2 = new com . thinairapps . tag . html . Anchor ( "Select * 
statement 2", path + " ?act ion=2 " , new com . thinairapps . tag . html . Text ( "Query ^ 
2 " ) ) ; 



mBody .addChild (an2) ,- 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) ) ; 



doc . set Body (mBody) ; 

//render the card and then output 
out . write (doc . render ( ) . getBytes ( ) ) ; 

} 
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else 

//else, the action parameter is populated 

//get the Provider Session 

{ 

ResultSet result; 

try 

{ 

//Create a session for this user 

//The session ID will be passed back and forth in the request URL 
sessionID = myCA. creat eProviderSess ion (Test Provider Con text .APP_NAME) ,* 
//reqProps .put ( "sid" , sessionID) ,- 

initProvider (sessionID) ; 

} 

catch ( Except ion e ) 

{ 

//catch initProvider exception here 

} 

//after init, retrieve data 

result = getResultSet (sessionID, action); 



ResultSetMetaData resultmeta; 
String headerl = null; 
String header2 = null; 

try 
{ 

//get metadata from result 
resultmeta = result .getMetaData () ; 

//get the first column label, the return is limited to 2 columns due to the SQL 
query 

headerl = resultmeta . getColumnLabel ( 1) ; 

//get the second column label 

header2 = resultmeta .getColumnLabel ( 2 ) ; 

} 

catch (Exception e) 

{ 

String emesg = e .getMessage ( ) ; 
System. err .println (emesg) ; 

} 



//retrieve data, generate page depending on client 
if (device instanceof WAPDevice) 

{ 

//Generate result page, using the metadata above to generate the header 
columns 

//<wml><card id= M result" title= "Results" ><p>< table columns= 11 2 " ><trxtd> 

Header</tdxtd>Header2</tdx/tr> 
//<trxtd>Details</tdxtdxDetails2</tdx/tr> . . . . </tablex/p></card></wml 

> 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( "Results ") ; 

com. thinairapps . tag .wml . Paragraph p = new com . thinairapps . tag . wml . 

Paragraph (com. thinairapps . tag .wml . Paragraph .ALIGN_LEFT, com. i*r 

thinairapps . tag .wml . Paragraph .MODE_WRAP) ; 
p .addChild (new com. thinairapps . tag .wml . Text ( " <b>Results</b> " ) ) ; 
p .addChild (new com . thinairapps . tag . wml . Break () ) ; 

com. thinairapps . tag . wml .Table resultTable = new com. thinairapps . tag . wml . *r 
Table ( "Results" , com . thinairapps . tag . wml . Table . ALIGN_CENTER, 2) ; 
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com. thinairapps. tag.wml .TableRow tr = new com. thinairapps . tag . wml . 
TableRow ( ) ; 

com. thinairapps . tag.wml .TableCell tcl = new com. thinairapps . tag .wml . 
TableCell {) ; 

com. thinairapps . tag.wml .TableCell tc2 = new com . thinairapps . tag . wml . 
TableCell () ; 

tcl .addChild(new com . thinairapps . tag .wml .Text (headerl) ) ; 

tc2 ,addChild(new com . thinairapps . tag . wml . Text (header2) ) ; 

tr. addChild (tcl) ; 

tr.addChild(tc2) ; 

resultTable . addChild ( tr) ; 

try 

{ 

String detain ; 
String detail2; 

//now go through the result set and render the table until result is 

empty 
while ( result . next ( ) ) 
{ 

detain = result .getString ( 1 ) ; 

detail2 = result .getString ( 2 ) ; 

tr = new com. thinairapps . tag . wml . TableRow () ; 

tcl = new com. thinairapps . tag .wml .TableCell () ; 
3 tc2 = new com. thinairapps . tag .wml .TableCell {) ; 

=5 tcl ,addChild(new com. thinairapps . tag .wml .Text (detaill) ) ; 

Jf tc2 . addChild (new com. thinairapps . tag .wml .Text (detail2) ) ; 

y tr. addChild (tcl) ; 

■4 tr .addChild(tc2) ; 

E. resultTable. addChild (tr) ; 

J } } 

hi catch (Exception e) 

g { 

String emesg = e . getMessage ( ) ; 
System, err .println (emesg) ; 

Q } 



p. addChild (resultTable) ; 
card.addParagraph(p) ; 
deck .addCard (card) ; 

//render the deck and output the result 
out . write (deck . render ( ) . getBytes ( ) ) ; 

} 

else 

if (device instanceof HTMLDe v ice) 

//Below is the result page, first the HTML source , then how the * 

HTML Tag libraries are used 
//<html><head>Here ( s the result</head><bodyxtable><trxtd> 

Headerl</tdxtd>Header2</tdx/tr> 
//<trxtd>detaill</tdxtd>detail2</tdx/tr> . . . .</table> 
//</bodyx/html> 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps . tag . html .Head head = new com.thinairapps.tag.html. * 
Head ( ) ; 

head. addChild (new com. thinairapps . tag . html .Text ( "Results" ) ) ; 

doc . setHead (head) ; 

Body mainbody = new Body ( ) ; 

com. thinairapps . tag. html .Paragraph mainpara = new com . thinairapps . tag 
. html . Paragraph ( ) ; 



com. thinairapps . tag . html .Table resulttable = 



new com. thinairapps . tag . 
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html .Table (1) ; 

com. thinairapps . tag . html . TableRow tr = new com.thinairapps.tag.html. 
TableRowO ; 

com. thinairapps . tag . html . TableCell tcl = new com . thinairapps . tag . html v 
.TableCell <) ; 

com. thinairapps . tag .html .TableCell tc2 = new com . thinairapps . tag . html 
.TableCell 0 ,- 

tcl . addChild(new com. thinairapps . tag . html . Text (headerl ) ) ; 

tc2 .addChild(new com. thinairapps . tag . html . Text (header2 ) ) ; 

tr .addChild(tcl) ; 

tr.addChild(tc2) ; 

resulttable.addChild(tr) ; 

try 

{ 

String details- 
String detail2; 

//run through the result set and render the table, until result 

is empty- 
while (result .next ( ) ) 
{ 

detail! = result .getString (1) ; 
detail2 = result . getString (2 ) ; 

tr = new com. thinairapps . tag .html .TableRow () ; 

tcl = new com. thinairapps . tag . html .TableCell () ; 

tc2 = new com. thinairapps . tag .html .TableCell () ; 

tcl . addChild (new com. thinairapps . tag . html . Text (detain ) ) ; 

tc2 .addChild (new com. thinairapps . tag . html . Text (detail2 ) ) ; 

tr .addChild (tcl) ; 

tr. addChild (tc2) 

result table. addChild (tr) ; 

} 

} 

catch (Exception e) 

{ 

String emesg = e . getMessage ( ) ; 
System. err .println (emesg) ; 

} 

mainpara . addChild (result table) ; 
mainbody. addChild (mainpara) ; 
doc . set Body (mainbody) ; 

//render the document and output the result 
out .write (doc . render ( ) .getBytes ( ) ) ; 



} 

private void initProvider (String sessionID) throws Exception 

{ 

//Retrieve the StoreProviderProxy for an existing session 
StoreProviderProxy spProxy = myCA.getStoreProvider (sessionID) ; 

//Construct this object for pedagogical purposes only 

StoreProviderLogin login = new StoreProviderLogin (null , null, null) ; 
Supportedltems supports = spProxy . connectUser ( login) ; 

if (supports == null) 

throw new Except ion ( "Error in connectUser. Provider is unavailable"); 



} 



private ResultSet getResultSet (String sessionID, String action) 

{ 

ProviderTestResult result = null; 
try 
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{ ... 

//Retrieve the St ore Provider Proxy for an existing session 

StoreProviderProxy spProxy = myCA.getStoreProvider (sessionID) ; 
//Construct the request object 

UserDataRequest request = new UserDataRequest () ; 
request . requests = new ItemRequest [1] ; 
request . requests [0] = new ItemRequest () ; 

//request .requests [0] . itemType = SimpleWebProviderContext . WEB_PROVIDER_RESULT ; 

request . requests [0] -bounds = new Bound[l]; 

request . requests [0] . bounds [0] = new ActionBound (action) ; 

//Contact the Provider and make the UserDataRequest 
UserData response = spProxy . getUserData (request ) ; 



//Extract the data 

Storeltems items = response . responses [0] . items ; 
result = (ProviderTestResult ) items . elementAt ( 0 ) ; 

} 

catch (Exception e) 
{ 

//Catch all exceptions and generate an error page 
e . printStackTrace ( ) ; 



} 

return result .getResultSet () ; 

} 
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import com. thinairapps . platform . provider . * ; 

import java.util.*; 
import java.io.*; 
import j ava . sql . * ; 

public class TestProvider implements StoreProvider 
Connection con = null; 

public Supportedltems connectUser (StoreProviderLogin login, StoreProviderContext context) 

^ //Create a connection object here to connect to the actual database, if we use 
//an actual login, we use the StoreProviderLogin to get the data 
//returns nothing since we don't have any thing for supported items 
//perhaps we can do read or write as supported. Normally in groupware it would be 
//messages, contacts, calendar, etc . . . 

Supportedltems supportedltems; 

//open connection to DB 

try 

{ 

//Using the Microsoft JDBC ODBC Driver 

Class . f orName ( "com.ms . jdbc . odbc . JdbcOdbcDriver " ) ; 

15=1 

£3 //here's the sun driver 

[? / /Class . f orName ( " sun . j dbc . odbc . JdbcOdbcDriver " ) ; 

!1 } 

=3 catch (Exception e) 

^ System. out .println ("Failed to load JDBC/ODBC driver."); 

^1 return null; 

s } 

//Be sure to establish a ODBC connection with Northwind as the DSN 
J String URL = 11 jdbc : odbc : Northwind" ; 

$ - 

^ //there is no username or password 

Jj //retrieve login and password from the StoreProviderLogin Object 

3 String username = login. name, - 

js. String password = login . password; 

try 

{ 

//try to establish connection 

con = DriverManager . getConnection (URL, username, password) ; 

} 

catch (Exception e) 

{ 
} 

//need to return a Supportedltems object, even though we do not use that in this 
//sample application 

// Support no actions 

supportedltems = new Supportedltems () ,- 
String name = TestProviderContext . APP_NAME ; 
String location = "none" ; 
short actions [] = new short [0] ,- 

Supportedltem item = new Supportedl tern (TestProviderContext . RESULT, name, location/ 

, actions) ; 
supportedltems . addl tern (item) ,- 

return supportedltems; 

} 

public void disconnectUser ( ) 
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} 



try 
{ 

con . close { ) ; 

} 

catch (Exception e) 

System. err .println ( "Error on closing") ; 

} 

con = null; 

//disconnectUser, disconnect from the DB, set all connections to NULL 



public UserDataActionResponse doUserDataAction (UserDataAct ion action) 
{ return null ; 

//This is the WRITE action. So the same here. -send in SQL in the UserDataAct ion? or 
//maybe send in a number which correlates to a SQL internally in backend 

} 

public UserDataLocations getLocations (UserDataLocationRequest req) 
{ return null; 

//No locations for this app. .perhaps we can specify a database for a location. . .hmmmm 

} - ■ . 

public UserData getUserData (UserDataRequest request) 

Id //Get the actual request, which is in the UserDataRequest (request object) 

ijl itemRequest itemReq = request . requests [0] ; 

'H // Prepare the return object 

,C UserData ud = new UserData () ; 

l,i //Create one ItemRequest Response array entry (Why does it need to be an array?) 

^ ud. responses = new ItemRequestResponse [ 1 ]; 

'H //Now actual populate the 1st index with an ItemRequestResponse object 

|Q ud. responses [0] = new ItemRequestResponse () ; 

//Set the request field to the itemReq (the UserDataRequest object that was passed intf 

the parameters) 
ud. responses [0] . request = itemReq; 

//In the above, why do we need to store the actual itemReq, why not just use it? 

//What is the reason for the below? 
//short type = itemReq . itemType ; 

// Verify that the request is of the correct itemType 
//must change 

//if (type != /*SimpleWebProviderContext . WEB_PROVIDER_RESULT*/ ) 
// throw new Runt imeExcept ion ( "Unknown item request type: * f +type) ; 

// The requested URL is wrapped in a StringBound 

//Why put it into a bound object? Unless Bound is the actual request? 

StringBound bound = (StringBound) ud. responses [0] . request .bounds [0] ; 
String action = (String) bound . getValue () ,- 

//get the actual data.. the READ portion ... wrap a SQL statement or a numeric 
//represnetation of a SQL statement in the UserDataRequest 

Statement stmt = null ; 

ResultSet result = null; 



try 

{ 

//create a Statment 

stmt - con . createStatement ( ) ,- 

} 

catch (Exception e) 




C : \TASS\WirelessSDK\ . . \General\DatabaseProvider\src\TestProvider . java 3 

{ 

System. err . println ( "problems connectina to database"); 

} 

String query = null; 

//Determine which select statement to use 
//retrieve using the UserDataRequest object 
if (action. equals ("1") ) 

query = "Select CompanyName, Phone from Shippers;"; 

else 

//action equals 2 so use second SQL 

query = "SELECT DISTINCTROW TOP 10 Product s . Product Name , Products .UnitPrice FROM 
Products ORDER BY Products . UnitPrice DESC;"; 

try 
{ 

//execute the query 
result = stmt . executeQuery (query) ; 

} 

catch (Exception e) 

{ 

String emesg = e . getMessage ( ) ; 
System- err .println (emesg) ; 

} 



ProviderTestResult returnresult = new ProviderTestResult (result) ; 

//return the result set and resultmeta data back to the connector 

// Finish loading the return object 

ud. responses [Oj . items = new Storeltems ( ) ; 

ud. responses [0] . items . addElement ( returnresult ) ; 

//close statement 

//try 

//{ 

//stmt .close ( ) ; 

//} 

//catch (Exception e) 

//{ 
//} 



return ud; 

} 

} 
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//Core ThinAir Server API functionality 
import com. thinairapps .plat form. provider . * ; 

public class ActionBound extends StringBound 

public ActionBound (String action) 

^ super (action, StringBound . COND_EQUALS) ; 
} 

} 




C: \TASS\ . .\General\DatabaseProvider\src\ProviderTestResult . java 

//Core ThinAir Server API functionality 

import com. thinairapps .platform. * ; 

import com. thinairapps . platform. provider . * ; 

import java.util.*; 

import j ava . sql . * ; 

public class ProviderTestResult extends Storeltem 
{ 

private ResultSet result; 
public ProviderTestResult (ResultSet r) 

{ 

super ( ) ; 
result = r; 

} 

public ResultSet getResultSet ( ) 

{ 

return result; 

} 

} 
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Wireless Forms sample Application 
wireless SDK for ThinAir server 



About this Sample 



The goal of this application is to provide an example of an application which 
interacts with a JDBC-accessi ble relational database. Forms and views are 
displayed in both html and wml, allowing the user to update and query data in 
a remote database from their wireless device. 

wireless Forms Applications are defined in a simple XML document which 
conforms to the following framework (there is no DTD defined): 

application name=" M > 
<database> 

<dsnx/dsn> 
<loginx/login> 
<passwordx/password> 
</database> 
<vi ews> 
_ <view name=""> 

f~j; <queryx/query> 
,|S </view> 
'M </views> 
VB <forms> 
[ r ~ z <form name=""> 

'H <queryx/query> 
IP <mappings> 
1*\ <mapping> 
1 <inputx/i nput> 

<fieldx/field> 
^ </mappi ng> 

III </mappings> 
</form> 
</forms> 
^3/application> 

IPere is an example Application definition: 

•^application name="user Manager"> 
ill <database> 

<dsn>jdbc:odbc: sample_app</dsn> 
M <login>userl</logi n> 

i-a. <password>password</password> 
5 '"" </database> 
<vi ews> 

<view name-"users"> 

<query>SELECT login as users, password AS Pwd from users</query> 
</vi ew> 
</vi ews> 
<forms> 

<form name="New user"> 

<query>insert into users (login, password) select 'Sign*, 1 $ pwd f </que ry> 

<mappings> 

<displ ay> 

<i nput>UserName</i nput> 
<f i el d>l gn</f i el d> 
<type>text</type> 



</di splay> 
<displ ay> 



</di splay> 
</mappings> 
</form> 
</forms> 
</app!ication> 



<i nput>Password</i nput> 
<f i el d>pwd</f i el d> 
<type>password</type> 



For the two included sample applications to run you need to register them with 
an ODBC dsn as follows: 
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sample.mdb DSN: "sample_app" 
northwin.mbd DSN: "Northwind ' 

note : The included sample databases are only appropriate for use on 
Microsoft windows systems. 




Requi rements 

This sample requires the following SDK jars: 

* platform. jar 

* taglib.j ar 

* devices. jar 

it also requires the following jars included with the sample: 

* dom.jar 

* xm!4j.jar 



Sample Files 



iShis sample consists of the following file tree: 
IB connector.ini - sample connector configuration file 
2? /src - Java sample code 
sfi /bin - compiled Java sample code 



building the Sample 



fljompile the sample code using the Java compiler of your choice. The included 
i^MAKE script will compile the sample using the JDK , if available. 

Onstall the Connector classes, the connector.ini configuration file, and the 
^Applications" directory with the XML application definitions, into a 
Usubdi rectory of the ThinAir Server's /connectors subdirectory, given a name 
f^of your choice. 

lUwake sure all of the databases specifed in the xml application definitions 
are accessible, if you are using the sample MS Access databases, make 
sure the Data source Names (dsns) are configured through the ODBC datasource 
manager, available in the control Panel. 

The jars xml 4 j. jar and dom.jar must be added to your class path. Edit the file 
Startserver.bat to include the following entries: 

Connectors/wi relessForms/xm!4q .jar; 
Connectors/wi rel essForms/dom.jar ; 

Start the ThinAir server, it should load wi relessFormsConnector , which should 
then in turn load all xml application definitions within its defined 
"ApplicationDefi nitionDi rectory" directory. The directory defined in the 
supplied connector.ini is "<thi nai rserver install di rectory>\connectors 
\wi rel essforms\appli cations" Place the xml files into that directory. 



Using the Sample 



wait until the Thi nAi rserver has started and the wi rel essFormsConnector 
has been loaded and initialized. From your wireless device or web browser, 
enter the IP address of your machine/wforms (or whatever the value for 
Application Path is set to in connector.ini above. For a machine 
with IP address 111.222.12.34 this would be: 
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http : //111- 222 . 12 . 34/wf orms 

Supported devices include WAP: phones, hdml phones, Palm pilots, windows ce 
devices, desktop web browsers, and GO America/GO rim pagers, to create a pqa 
application for the Palm VII that integrates with the ThinAir server, you 
will need to understand and use "web Clipping" technology from Palm, web 
Clipping involves essentially creating html interfaces into your applications. 
For your convienence, an html file (wforms.html) has been provided for 
this purpose. To find out more about creating PQAs and web Clipping 
technology, visit: http://www.palmos.com/dev/tech/webclipping/ 



Last updated: 11.18.2000 
Copyright 1999, 2000 ThinAirApps inc 



Page 3 



C: \TASS\WirelessSDK\Samples\Applications\WirelessForms\src\WView. java 1 

I * * 

* @(#) WView. java 
* 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF kT 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 

public class WView 



{ 



private String name; 

private String key; 
private String key_query; 

private String query; 

public WView (String name, String key. String key_query, String query) 

this. name - name; 
this. key - key; 
this. query = query; 

public String getName ( ) 
return name; 

public String getKeyO 
return key; 



public String getQueryO 
return query; 
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I * * 

* @(#) WMLResultSetDeck. java 
* 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 

* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF * 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 

import com. thinairapps . tag . wml . * ; 
import j ava - sql . * ; 

public class WMLResultSetDeck extends WMLTagDocument 
{ 

/* * 

* Returns the result in Table format 
* 

* ©param resultSet is a ResultSet from the query results 
* 

■ss-s 

0 public WMLResultSetDeck (ResultSet resultSet) throws SQLException 
/l super ( ) ; 

P ResultSetMetaData metaData = resultSet . getMetaData () ; 

=j int numberOf Columns = metaData .getColumnCount () ; 



//for each row first display primary key 

Card card = new Card ( !, kl" , "View" ) ; 
String value = null; 

Paragraph p = new Paragraph < Paragraph. ALIGN_LEFT, Paragraph -MODE_NOWRAP) ; " 

int keyldx = 1 ; 

int rowldx - 0 ; 

String cardName = null; 

addCard (card) ; 

p.addChild (new Bold (metaData .getColumnLabel (1) ) ) ; 
p.addChild (new Break ( ) ) ; 
card. addChild (p) ; 

int max = 10 ; 

while (resultSet . next ( ) && rowldx < max ) 

{ 

cardName = "r" + rowIdx++; 
value = resultSet .getObject (keyldx) . toString () ; 

p.addChild(new Anchor(new Go("#" + cardName, false) , new Text (value) )) ; 

Card card2 = null; 
String label = null; 

card2 = new Card (cardName) ,- 

Paragraph p2 = new Paragraph (Paragraph. AL I GN_LE FT, Paragraph . MODE_NOWRAP ) ; 
for (int column = 2; column <= numberOf Columns ; column++) 

{ 

label = metaData .getColumnLabel (column) + " : " ; 
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value = resultSet .getObject (column) - toString () ; 
p2 .addChild(new Bold ( label )) ; 
p2 .addChild(new Text (value) ) ; 
p2 .addChild(new Break ()) ,* 



card2 . addChild (p2 ) 
addCard (card2) ; 
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/** 

* @(#) WMLApplicationRenderer - java 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF ^ 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 

import com . thinairapps . tag . * ; 
import com . thinairapps . tag . wml . * ; 

import java .util . Enumeration; 
import java . util .Vector ; 
import java .net .URLEnc Oder ; 

import java .util . Properties ; 

import j ava . sql . * ; 

I * * 

13* This class implement the ApplicationRenderer interface. See that class for 
*0* more information on each method. 

public class WMLApplicationRenderer implements ApplicationRenderer, ApplicationConstants 

: F 

1 ^ / * * 

"~4 * Render all currently loaded applications in a selectable list 

ilQ * 

* ©param apps a hashtable of Application objects 
* 

W * ©return a String with WML tags 

m */ 

]~ public String renderApplications (java .util .Hashtable apps) 

m { 

O Paragraph p = new Paragraph (Paragraph . ALIGN_CENTER, Paragraph . MODE__NOWRAP) ; 

p.addChild(new Text ( "Choose Application : 11 )) ; 
p.addChild(new Break ()) ; 

String action = null; 

Enumeration enum = apps . elements () ; 

Application app - null; 

String url = null; 

Properties urlProps = new Properties () ; 
url Props. put ( ACT I ON_ARG , MENU_ACT I ON ) ; 

while (enum . hasMoreElements ( ) ) 

{ 

app = (Application) enum .nextElement () ; 
url Props . put ( APP_ARG , app . getName ( ) ) ; 

url = URLBuilder .buildWapUrl ("?", urlProps , true) ; 

p.addChild(new Anchor(new Go (url , false) , new Text (app . getName ()))) ; 
p.addChild (new Break ()); 

} 
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WMLTagDocument doc - new WMLTagDocument ( ) ; 

Card mCard = new Card ( "wf ", "Wireless Forms"); 
mCard.addChild(p) ; 

doc . setCard (mCard) ; 

return doc . render () ; 

} 

/ * * 

* Render a menu for a single Application that allows you to select WForms and WViews 
* 

* ©param app an Application instance 
* 

* ©return String with WML Tags for a menu 
*/ 

public String renderMenu (Application app) 

^ Paragraph p = new Paragraph ( Paragraph . ALIGN_CENTER , Paragraph . MODE_NOWRAP ) ; 

p .addChild (new Text ( n Choose Application :")) ,- 
p . addChi Id ( new Break ( ) ) / 

KSSr 

S String action = null; 

tj Enumeration enum = app . get Forms () ; 

I~ 

e _'s WForm form = null; 

*4 p . addChild (new Bold ( " FORMS : " ) ) ; 

jl p. addChild (new Break ( ) ) ; 

_ String url = null; 

Properties urlProps = new Properties () ; 
U urlProps .put ( ACT I ON_ARG , FORM_ACT I ON ) ; 

J url Props . put ( APP_ARG , app . get Name ( ) ) ; 

~\ while (enum.hasMoreElements ( ) ) 

" { 

form =. (WForm) enum. next Element () ; 
urlProps .put (ITEM_ID, form. getName ( ) ) ; 

url = URLBuilder .buildWapUrl ( urlProps , true) ; 

p. addChild (new Anchor(new Go (url , false) , new Text (form. getName ()))) ; 
p .addChild (new Break() ) ; 

} 

enum = app .getViews ( ) ; 

WView view = null; 

p. addChild (new Bold ( "VIEWS :") ) ; 
p . addChild (new Break ()) ; 

urlProps. put { ACT I ON_ARG , VI EW_ACT I ON ) ; 



while (enum . hasMoreElements ( ) ) 

{ 

view = (WView) enum . nextElement () ; 

urlProps .put ( ITEM_ID, view . getName ( ) ) ; 

url = URLBuilder .buildWapUrl ( " ? " , urlProps , true) 
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p. addChild (new Anchor (new Go (url , false) , new Text (view . getName ()))) ; 
p. addChild (new Break () ) ; 

} 

p . addChild {new Break () ) ; 



WMLTagDocument doc = new WMLTagDocument ( } ; 

Card mCard = new Card ( "wf" , "Wireless Forms"); 
mCard. addChild (p) ; 

doc . setCard(mCard) ; 

return doc . render ( ) ; 

} 



/ * * 

* Render a JDBC ResultSet for a particular Application and a particular WView 

* - 

* ©param app the application the WView is from 

* ©param view the WView the ResultSet was generated from 

* ©param resultSet the resultSet generated from a view and its SQL query 
0 * 

£: * ©return String with WML tags with the result set from the database query 

!1 */ 

£~ public String renderView (Application app, WView view, ResultSet resultSet) 

y try 

S return new WMLResultSetDeck (resultSet ). render () ; 
} 

=~ catch (SQLExcept ion se) 

P return se . toString ( ) ; 

3 ) 

3 } 

* Render a particular application's form 
* 

* ©param app the application the WForm is a part of 

* ©param form the WForm to render 
* 

* ©return a String with the WML form 
*/ 

public String renderForm (Application app, WForm form) 

java .util . Properties props = f orm .getDisplayMap <) ; 

Enumeration keys = props . keys ( ) ; 
String key = null, label = null; 



java .util . Properties urlP = new j ava . util . Properties () ; 
urlP.put ( "ap" , app .getName ( ) ) ; 
urlP.put ( "a" , INSERT_ACTION) ; 
urlP . put ("i", form . getName ( ) ) ; 

MultiplelnputCard mic = new Mult iplelnputCard ( "cl " , form . getName ()) ,- 
Labeledlnput [] li = new Labeledlnput [props . size ()] ; 
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int i = 0 ; 

while (keys . hasMoreElements { ) ) 

key = (String) keys . next Element () ; 
label = (String) props. get (key) + " : " ; 
li[i++] = new Labeledlnput (key , label ) ; 
urlP.put (key, M $ ,f +key) ; 

} 

String url = URLBuilder . buildWapUrl ( " ? " , urlP, true) ; 
mic.buildCard (url, "Submit " , li , Go . METHOD_GET) ; 
WMLTagDocument deck = new WMLTagDocument { ) ; 
deck.addCard(mic) ; 
return deck . render <) ; 



* Render a confirmation message with a link to a specific URL 
* 

* Oparam app the Application the confirmation is for 

* ©param title the title to display for the confirmation 

* ©param message the confirmation message to display 

* ©param url the url to provider a link to 
* 

* ©return String with WML tags with confirmation message 
*/ 

public String renderConf irmation (Application app, String title, String message, String 
url) 



{ 



Paragraph p = new Paragraph (Paragraph. ALIGN_CENTER, Paragraph. MODE_WRAP) ; 
p.addChild (new Text (message) ) ; 

Properties urlProps = new Properties () ; 
urlProps . put ( ACT I ON_ARG , AP P_ACT I ON ) ; 
urlProps. put (APP_ARG, app. getNameO ) ; 

p.addChild (new Anchor (URLBuilder . buildWapUrl ("?", urlProps , true) , ,, Ok n ,new Text 
("Ok") ) ) ; 

WMLTagDocument page = new WMLTagDocument ( ) ,* 

Card card = new Card ( "cl title) , • 
card.addChild(p) ; 
page . addCard( card) ; 

return page . render ( ) ; 
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I * * 

* @ (#) WirelessFormsConnector . java 

* Copyright (c) 2000 ThinAirApps , Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF * 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 

//thinair platform imports 

import com. thinairapps. plat form. connector . * ; 
import com . thinairapps . platform . provider . * ,* 
import com. thinairapps . platform . exception . * ,- 
import com. thinairapps .plat form. device . * ; 

//standard java imports 
import java.util.*; 
import j ava . io . * ; 

/* 

,f|* This Connector provides wireless clients with a simple 

user interface for interacting with a relational database 
or other JDBC/ODBC accessible data. 

"4/ 

„||ublic class WirelessFormsConnector implements Connector, ApplicationConstants 

I'M 

""~4 //the main appplication logic class which this Connector employs 
|Q WirelessForms wf = null; 

Lz, //globals to hold information on jdbc drivers and application directory location 
\ J private String DB_DRIVER = null; 
ijl private String APP_DIR = null; 

if / * * 

*<*J * initialize the connector 

O * ©param name of application 

a_ * ©param path to application from URL 

"'" * ©param iniProps from the connector.ini file 

* ©param ca interface for Connectors to access the server 

* ©param al used for logging 
*/ 

public void init (String appName, String appPath, Properties props, Connect or Access ca, 
com. thinairapps .platform, connect or . ApplicationLog al) 

{ 

//instantiate the central WirelessForms object, shared across all requests 
wf = new WirelessForms (appPath) ; 

//get the XML application definition directory from provider.ini 
if (props .getProperty ( "Applicat ionDef initionDirectory" ) ! = null) 

APP_DIR = props .getProperty { "Applicat ionDef initionDirectory" ) ; 

else 

APP_DIR = DE FAULT_AP P_D I R ; 

//get the JDBC database driver from provider.ini 
if (props . getProperty ( "DatabaseDriver" ) null) 

DB_DRIVER = props .getProperty ( "DatabaseDriver" ) ; 

else 

DB DRIVER « MS_DB_DRIVER ; 



//attempt to initialize WirelessForms object 
try 
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{ 

wf.init (APP_DIR, DB_DRIVER) ,- 

} 

catch (Exception e) 

^ System. err .println ( "WirelessFormsConnector . init : error on WirelessForms init 
: " + e) ; 
e . printStackTrace ( ) ; 

} 

} 

f * * 

* handle an incoming request 

* ©param reqProps represents the HTTP request 

* ©param device the actual wireless device instance making the request 

* ©param out the OutputStream to write back the response 
*/ 

public void handle (Properties req, Device device, OutputStream out) 
{ 

//extract current action using defined variable name constant 
String action = req .getProperty (ACTION_ARG) ; 

//init object used to store output from renderering 
String output - null; 

f% //init the renderer superclass 

J? ApplicationRenderer renderer = null; 

*J //based on the device type, determine which subclass of 

r= //ApplicationRenderer to use. Since some WAP devices also 

*. //supports HTML, we will specifically look for WAP suport first 

^ if (device instanceof WAPDevice) 

^ { 

g //its a WAP device, so create a WML Renderer 

renderer = new WMLApplicationRenderer (); 

} 

J else if (device instanceof HTMLDevice) 

ji { 

~i //its a HTML deice, so create an HTML Renderer 

f? renderer = new HTMLApplicationRenderer (); 

2 } 

^ //if the action is NULL or is the default APP_ACTION 

//get the list of available applications 
if (action null || action . equals (APP_ACTION) ) 
output = wf .getApplications (renderer) ; 

//the action tells the server to reload application definitions 

else if (action. equals (RELOAD_ACTION) ) 

{ 

try 
{ 

wf . init (APP_DIR # DB_DRIVER) ; 

output = wf .getApplications (renderer); 

} 

catch (Exception e) 

System. err .println ( "WirelessFormsConnector . handle : error on WirelessForms 
init : " + e) ; 

} 

} 

//retrieve and render a Menu, which display Forms and Views, for a specific 

Application 
else if (action. equals (MENU_ACTION) ) 

output = wf .getMenu (req. get Property (APP_ARG) , renderer); 



//retrieve and render a View (essentially a JDBC ResultSet) 
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else if (action. equals (VIEW_ACTION) ) 

output = wf .getview(req. get Property (APP_ARG) , req. get Property (ITEM_ID) ,req. 
getProperty (KEY) tenderer) ; 

// 

else if (action. equals (FORM_ACTION) ) 

output = wf .getForm( req. get Property (APP_ARG) , req . getProperty ( ITEM_ID) tenderer) ; 

//insert data into a table, and display a confirmation 
else if (action. equals (INSERT_ACTION) ) 

^ output = wf . insertEntry (req . getProperty (APP_ARG) , req . getProperty ( ITEM_ID) , req, 
renderer) ; 

} 

//write the output to the OutputStream via a PrintWriter 
PrintWriter ps = new PrintWriter (out ) ; 
ps .print In (output) ; 
ps . f lush( ) ; 
ps . close ( ) ; 

} 

/ * * 

* ©return String array containing the names of all DeviceProf iles supported by this 

Connector. 

* These names are the friendly names used to uniquely identify every * 
DeviceProf ile . 

*/ 

\U public String [] getDevices () 

?S //This connector will specify three devices: PalmVII, any 

//HTML mini -Browser device and any WAP mini -browser device 
tJ String [] devices = {WAPDeviceProf ile .NAME , PalmVII DeviceProf ile .NAME , HTMLDeviceProf ile * 

h iJ .NAME}; 

return devices; 

T } 

S3 



^ ess? 
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/ * * 

* ©{#) Wire less Forms . java 
* 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE * 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 

import org . w3 c . dom . * ; 
import dom.*; 

import java.util.*; 
import j ava . sql . * ; 
import j ava .net.*; 



/ * * 

* This class contains primary application logic for the WirelessForms 

* application. 

_*/ 

-public class WirelessForms implements ApplicationConstants 

. . 

//stores all loaded appicat ions 
=M private Hashtable apps; 

a f2 //stores the JDBC driver to use 

\\\ private static String DRIVER = null; 

\ far 

H -i private static final String DEFAULT_PARSER_NAME = "dom. wrappers .DOMParser" ; 

private static String m_appPath; 

M public WirelessForms (String appPath) 

;g super () ; 

':: m_appPath = appPath; 

JfJ } 

il /* 

* build forms and view, store in hashtable 
*/ 

public void init (String AppDir, String DRIVER) throws Exception 
{ 

this. DRIVER = DRIVER; 

apps = new Hashtable () ; 
Application app = null; 

StringU files = new java . io. File (AppDir) . list () ; 

for (int i = 0; i < files . length; i++) 

app = buildAppFromXML (AppDir + "/" + files [i]); 
apps .put (app.getName ( ) , app) ; 

> 

> 

f * * 

* loads an Application Definition from a URL and creates an Application object 

* from it using a DOM parser 
*/ 

private static Application buildAppFromXML (String uri) throws Exception 
{ 



# 
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DOMParserWrapper parser = (DOMParserWrapper) new dom. wrappers .NonValidatingDOMParser 
0 ; 

Document document = parser . parse (uri ) ,- 

String appName = ( (Element) document .getElementsByTagName ( "application" ). item (0) ) . 
getAttribute ( "name" ) ; 

// Get the source info 

Element dbElement - (Element ) document . getElementsByTagName ( "database "). item (0); 
String dsn = getSubNode Value (dbElement, "dsn") ; 
String login = getSubNode Value (dbElement, " login" ); 
String password = getSubNodeValue (dbElement, "password"); 

Application app = new Application (appName , dsn, login, password, m_appPath) ; 

NodeList viewElements = document .getElementsByTagName ("view") ; 
Element viewElement = null; 

WView view = null; 

String viewName, key , key_query, query; 

for (int i = 0; i < viewElements .getLength (),- i + +) 

{ 

viewElement = (Element ) viewElements . item (i); 

viewName . - viewElement . getAttribute ( "name " ) ; 

key = getSubNodeValue (viewElement, "key"); 

key_query = getSubNodeValue (viewElement, n key_query" ) ; 

query = getSubNodeValue (viewElement, "query"); 

view = new WView (viewName , key , key_c[uery, query) ; 
app. addView( view) ; 

} 

NodeList formElements = document . getElementsByTagName ("form"); 
Element formElement = null; 

WForm form = null ; 

String formName, formQuery, dlnput, dField; 
Properties dProps = null; 

for (int i = 0; i < f ormElements . getLength ( ) ,- i + +) 

{ 

formElement = (Element ) formElements . item (i) ; 

formName = formElement .getAttribute ( "name" ) ; 

formQuery = getSubNodeValue (formElement, "query") ; 

dProps = new Properties () ; 
NodeList dElements = null; 
Element dNode = null; 

Element dMap = (Element ) formElement . getElementsByTagName ( "mappings "). item ( 0 ) ; 
dElements = dMap . getElementsByTagName ( "display ") ; 

for (int n = 0; n < dElements . getLength () ; n++) 

{ 

dNode = (Element) dElements . item (n) ; 
dlnput = getSubNodeValue (dNode, "input"); 
dField = getSubNodeValue (dNode, "field"); 
dProps. put (dField, dlnput); 

} 

form = new WForm (formName, formQuery, dProps) ; 
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} 



app.addForm (form) ; 

} 

return app; 



* gets value from a subnode of the passed element 

*/ 

private static String getSubNodeValue (Element element , String node) 
{ 

try 

{ 

return ( (Element) element .getElementsByTagName (node) .item(0)) . getFirstChild ( ) . \£ 
getNodeValue ( ) . trim ( ) ; 

} 

catch (Exception e) 

{ 

return null; 

} 

} 

J * * 

* open a connection to the database specified by an Application 
§3 * and store it in the Application object 

*D */ 

^ public void connect (String appName) throws Exception 

Application app - (Application) app s .get (appName) ; 
= C app. setConnection (DatabaseTool .openConnection(app.getDSN ( ) , DRIVER, app . getLogin ( ) , app, 

s % getPassword ( ) ) ) ; 

is /* 

* enumerate through apps 

*/ 

public String getApplications (ApplicationRenderer renderer) 
return renderer . renderApplicat ions (apps) ; 

-■7 - 

hi /* 

* enumerate through forms and views and build menu 
*/ 

public String getMenu (String application, ApplicationRenderer renderer) 

Application app = (Application) apps . get (application) ; 
return renderer . renderMenu (app) ; 

} 

/* 

* get view name with key value, execute query, display table output 
*/ 

public String getview (String application. String name. String key, ApplicationRenderer \£ 
renderer) 

{ 

try 

{ 

Application app - (Application) apps . get (application) ; 

if (app.getConnection ( ) == null || app . getConnect ion ( ) . isClosed ( ) ) 
connect (application) ; 

WView view = app.getview (name) ; 

ResultSet resultSet = DatabaseTool . executeSelect (view . getQuery (), app . getConnect ion 
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0 ) ; 

String out - renderer . renderView (app, view, resultSet ) ; 
resultSet . close ( ) ; 
return out ; 

} 

catch ( Exception se ) 

return se . toString ( ) ; 

} 

} 

/* 

* build input form from form object 
*/ 

public String getForm (String application, String name, ApplicationRenderer renderer) 

Application app = (Application) apps .get (application) ; 
WForm form = app -getForm (name) ; 
return renderer . renderForm (app, form) ; 

} 

/* 

* replace vars in insert string, execute insert query, display result 
*/ 

public String insertEntry (String application. String name. Properties props, 
ApplicationRenderer renderer) 



{ 



Application app = (Application) apps .get (application) ; 

System. out .println ( "got app: " + app .get Name ()) ; 
WForm form = app. get Form (name) ; 

System. out .println ( "got form: " + f orm . getName ()) ; 

String url = "/?a=f&i=" + URLEncoder . encode ( form. getName {) ) + "&ap=" + URLEncoder. 
encode ( app . getName ( ) ) ; 

try 
{ 

if (app .getConnection ( ) == null || app .getConnection ( ) . isClosed ( ) ) 
connect (application) ; 

Enumeration enum = props . keys 0 ; 
String key = null, value - null; 

String query = f orm . getQuery ( ) ; 

System. out .println ( "query : " + query); 

while (enum . hasMoreElements ( ) ) 

{ 

key = (String) enum. nextElement () ; 
value = props .getProperty (key) ; 
System. out .println (key + "=" + value); 
query = substitute (query, "$" + key,value); 
System. out .println ( "updated query: " + query); 

> 

DatabaseTool . executelnsert (query, app .getConnection ( ) ) ; 

return renderer . renderConf irmat ion (app, "Success ", "Your data was successfully 
submitted . " , url ) ; 

} 

catch (Exception se) 




# 
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return renderer . renderConf irmation (app, "Error" , "There was an error submitting- 
your query: M + se .getMessage ( ) ,url ) ; 



/ * * 

* basic utility app for doing a String substitute 
*/ 

private static String substitute (String s, String old, String replace) 
{ 

int last, first = 0 ,- 
String foo, bar,* 

StringBuffer out = new StringBuf fer () ; 
while (s. indexOf (old, first) > 0) 



last = s . indexOf (old, first ) ; 
foo = s. substring (0, last) ; 

bar = s.substringdast+old.lengthO , s. length () ) ; 

out . append ( foo) ,- 

out . append (replace) ; 

out . append (bar) ; 

s = out . toString ( ) ; 

out = new StringBuf fer () ; 

first = f oo . length () +replace . length () ; 



return s; 
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/** 

* @(#)HTMLResultSetTable. java 
* 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS , INC- AND LICENSEE . ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED . 
* 

*/ 

import com . thinairapps . tag . html . * ; 
import j ava . sql . * ; 

/ * * 

* An HTML Tag Lib widget for rendering a JDBC ResultSet in a simple format 
*/ 

public class HTMLRe suit Set Table extends Table 

{ 

* Returns the result in Table format 
* 

□ * ©param resultSet is a ResultSet from the query results 

is * ©parma borderSize is a int defining the bordersize of the Table 

K */ 

^ public HTMLResultSetTable (ResultSet resultSet, int borderSize) throws SQLException 
g super (borderSize) ; 

TableRow tr = new TableRowO; 
j-] TableCell cell = null; 

ResultSetMetaData metaData = resultSet .getMetaData () ; 
ll int numberOf Columns = metaData .getColumnCount () ; 

2 for (int column = 0; column < numberOf Columns ; column++) 

U { 

y cell = new TableCell (); 

^ cell .addChild (new Bold (metaData .getColumnLabel (column+1 ))) ; 

tr.addChild(cell) ; 

} 

addChild (tr) ; 

while (resultSet .next () ) 

{ 

tr = new TableRowO ; 

for (int i = 1; i <= numberOf Columns ; i++) 

{ 

cell = new TableCellO; 

cell .addChild (new Text (resultSet . getObj ect ( i ) . toString ( ) ) ) ; 
tr.addChild(cell) ; 

} 

addChild (tr) ; 

} 

} 

} 
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/ * * 

* @ ( # ) WForm . j a va 
* 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF vT 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 

import java .util . Properties / 
/ * * 

* The basic WirelessForm form object. Instances of this class are built 

* automatically from the XML Application Definition. 
*/ 

public class WForm 

{ 

private String name; 
private String query; 
private Properties displayMap; 

zf / * * 

M * ©param name the displayable form name 

B * ©param query the insert query to use for submitting the form data 

i-l * ©param displayMap a prop mapping form field variables to displayable labels 

=S */ 

*Z public WForm (String name, String query, Properties displayMap) 

=J this. name = name; 

this, query = query; 
- this .displayMap = displayMap; 



public String getName ( ) 
return name; 



public String getQueryO 
return query ; 



public Properties getDisplayMap ( ) 
return displayMap; 

} 
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/ ** 

* @ (#) HTMLAppli cat ionRenderer . java 

* Copyright (c) 2 000 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF kT 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 



//Thinair Tag Library 

import com . thinairapps . tag . * ; 

import com . thinairapps . tag . html . * ; 

//Java Utilities 
import java.util . Enumeration; 
import java .util .Vector ; 
import java .net .URLEncoder ; 

//Java SQL library 
import j ava . sql . * ; 

%** 

^f* This class implement the ApplicationRenderer interface. See that class for 
S* more information on each method. 

4*/ 

public class HTMLApplicat ionRenderer implements ApplicationRenderer, ApplicationConstants 

^ * Render all currently loaded applications in a selectable list 
* 

3 * ©param apps a hashtable of Application objects 
ll * ©return a String with HTML tags 

^ public String renderApplications ( java . util . Hashtable apps) 

i < 

"~ try 

{ 

Paragraph body = new Paragraph ( ) ; 

String action = null; 

Enumeration enum = apps . elements () ; 

Application app = null; 

// body .addChild (new Text ( " <b>Applications : </b><BR> " ) ) ; 

com. thinairapps. tag. html. Form hForm = new com . thinairapps . tag . html . Form 
("fl" , " " / "GET") ; 

Select select = new Select ("ap") ; 
select. addAttribute ( "size" , "3") ; 

while (enum. hasMoreElements ( ) ) 

app = (Application) enum. nextElement () ; 

//action = "?a^m&ap=" + URLEncoder . encode (app . getName ()) ; 
select .addOpt ion (app. getName ( ) , false) ; 

} 



# • 
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hForm.addChi Id (select) ; 
hForm.addChild (new Break ()) ; 

hForm.addChi Id (new Submi t But ton ( "Launch" ) ) ; 
hForm.addChild (new Anchor ( "Refresh" , "?a=r" ) ) ; 
hForm.addChild (new Hiddenlnput ( "a" , "m") ) ; 

HTMLTagDocumenf doc = new HTMLTagDocument { ) ; 
Head head = new Head ( ) ; 

head.addChild (new Title ( "Wireless Forms") ) ; 
doc . setHead (head) ; 

Body mBody = new Body ( ) ,- 

mBody . addChild (new Bold("Select an application:")),- 
mBody.addChildtnew Break ()) ; 
mBody . addChild (hForm) ; 

doc . setBody (mBody) ; 
return doc . render ( ) ; 
} 

catch (InvalidTagExcept ion ite) 
s^j return null; 

;s . } 



/ * * 

* Render a menu for a single Application that allows you to select WForms and WViews 
* 

* ©param app an Application instance 
* 

* ©return String with HTML Tags for a menu 
*/ 

public String renderMenu (Application app) 

{ 

try 
{ 

Paragraph body = new Paragraph () ; 

Enumeration views = app .getViews ( ) ; 
WView view = null; 
String action = null; 

com. thinairapps . tag . html . Form viewForm = new com . thinairapps . tag . html . Form 
("views", " " , "GET") ; 

viewForm. addChild (new Text ("Views: " ) ) ; 
viewForm. addChild (new Hiddenlnput ("a", "v") ) ; 
viewForm. addChild (new Hiddenlnput ( "ap" , app . getName ( ) ) ) ; 
Select viewSelect = new Select ("i") ; 

while (views . hasMoreElements ( ) ) 

{ 

view = (WView) views . nextElement () ; 
viewSelect .addOpt ion (view . getName ( ) .false) ; 

} 

viewForm. addChild (viewSelect); 

viewForm. addChild (new SubmitButton ("Go")); 
body .addChild (viewForm) ; 



# # 
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body . addChild (new Break ( ) ) ; 

Enumeration forms = app . getForms ( ) ; 
WForm form - null; 

com. thinairapps . tag .html . Form formForm = new com. thinairapps . tag . html . Form *r 
("forms" , , "GET" ) ; 

formForm. addChild (new Text ("Forms: ")); 
formForm. addChild (new Hiddenlnput ( "a" , " f " ) ) ; 
formForm. addChild (new Hiddenlnput ( "ap" , app . getName ( ) ) ) ; 
Select formSelect = new Select ("i"); 

while ( forms . hasMoreElement s ( ) ) 

{ 

form - (WForm) forms .nextElement () ; 
formSelect .addOpt ion ( form. getName ( ) , false) ,- 

} . 

formForm. addChild (formSelect) ; 

formForm. addChild (new SubmitButton ("Go")); 
body .addChild (formForm) ,- 



y HTMLTagDocument doc = new HTMLTagDocument ( ) ,- 

3 Head head = new Head ( ) ; 

]j head. addChild (new Title (app . getName ())) ; 

2 doc . setHead (head) ; 

|j Body mBody = new Body ( ) ; 

•j mBody . addChild (body) ; 

^ doc . set Body (mBody) ; 

g return doc . render ( ) ; 

2 } 

~j catch (InvalidTagException e) 

n { 

=. return null ; 

j } 



} 

/ ** 

* Render a JDBC ResultSet for a particular Application and a particular WView 
* 

* ©param app the application the WView is from 

* ©param view the WView the ResultSet was generated from 

* ©param resultSet the resultSet generated from a view and its SQL query 
* 

* ©return String with HTML tags with the result set from the database query 
*/ 

public String renderView (Application app f WView view, ResultSet resultSet) 
{ 

try 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 
Head head = new Head ( ) ,- 

head. addChild (new Title (view .getName ())) ; 
doc . setHead (head) ; 

Body body - new Body ( ) ; 
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body .addChild (new Text("<font size=\"l\ n f ace=\ "geneva\ " > " ) ) ; 

Table table = new HTMLResul tSetTable (resultSet, 1) ; 

body.addChild(table) ; 

body .addChild (new Break ()) ; 

body .addChild (new HorizontalRule ( ) ) ; 

String main = n ?a=m&ap= ,! + URLEncoder . encode (app .getName ()) ; 
body. addChild (new Anchor { " " , main, new Text ( " E menu ]"))); 

body. addChild (new Text ( " </f ont > " ) ) ; 

doc . set Body (body) ; 
return doc . render ( ) ; 

catch (SQLException se) 

return se . toString () ; 
catch (InvalidTagExcept ion se) 

return se . toString () ; 



^ * Render a particular application's form 

ij * 

J * ©param app the application the WForm is a part of 

■q * ©param form the WForm to render 

* ©return a String with the HTML form 

" public String renderForm (Application app, WForm form) 
^ { 

- try 

D { 

7 java .util . Properties props = f orm .getDisplayMap ( ) ; 

//build an HTML Form Tag object to render the WForm 

com. thinairapps . tag .html . Form hForm = new com . thinairapps . tag . html . Form (" insert " , 
app.getWFormsURLO , "POST") ; 

Enumeration keys = props . keys () ; 
String key = null; 

while (keys . hasMoreElements ( ) ) 

{ 

key = (String) keys . nextElement () ; 
hForm. addChild (new NonBreakingSpace (4 ) ) ; 

hForm. addChild (new Text( !I <b> n + (String) props . get (key ) + " : </b>  " ) ) ; 
hForm. addChild (new TextField (key) ) ; 
hForm . addChi Id ( new Break ( ) ) ; 

} 

hForm. addChild (new Break ()) ; 

hForm. addFormElement (new Hiddenlnput (ACTION_ARG, I NS ERT_ACT I ON ) ) ; 
hForm. addFormEl erne nt (new Hiddenlnput (APP_ARG, app . getName () ) ) ; 
hForm. addFormElement (new Hiddenlnput ( ITEM_ID , form .getName ( ) ) ) ; 

Center center = new CenterO; 



# # 
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center .addChi Id (new Submi t But ton ( "Submit " ) ) ; 

center .addChild (new Input ( "Reset " , "Reset", "Reset") ) ; 

hForm. addChi Id (center) ; 

HTMLTagDocument page = new HTMLTagDocument { ) ; 
Head head = new Head ( ) ; 

head. addChild (new Title ( form. getName ())) ; 
page . setHead (head) ; 

Body body = new Body ( ) ; 
body . addChild (hForm) ; 
page . set Body (body) ; 

return page . render () ; 

} 

catch ( InvalidTagExcept ion ite) 

{ 

return ite . toString ( ) ; 

} 

} 



J ** 

* Render a confirmation message with a link to a specific URL 
* 

* ©param app the Application the confirmation is for 

* ©param title the title to display for the confirmation 

* ©param message the confirmation message to display 

* ©param url the url to provider a link to 
* 

* ©return String with HTML tags with confirmation message 
*/ 

public String renderConf irmation (Application app, String title, String message, String \l 
url) 

{ 

try 
{ 

Center center = new Center (); 

center .addChild (new HorizontalRule ()) ; 

center .addChild (new Text (message) ) ; 

center .addChild (new HorizontalRule () ) ; 

String main = "?a-m&ap=" + URLEncoder . encode (app . getName ()) ; 
center .addChild (new Anchor ( "Ok" , main) ) ; 



HTMLTagDocument page = new HTMLTagDocument ( ) ; 

Head head = new Head ( ) ; 

head. addChild (new Title (title) ) ; 

page . setHead (head) ; 

Body body = new Body ( ) ; 
body .addChild (center) ; 
page . set Body (body) ,- 

return page . render ( ) ,- 

} 

catch (InvalidTagExcept ion e) 

{ 

return e . toString ( ) ; 

} 



} 
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f * * 

* @ (#) DatabaseTool . java 
* 

* Copyright (c) 2 00 0 ThinAirApps, Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF yf 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 

import j ava . sql . * ; 
/ ** 

* A utility class that wraps JDBC querying logic 
*/ 

public class DatabaseTool 

{ 

/ * * - 

* Open a JDBC connection for a particular DSN, username, and password 

*/ 

=| public static Connection openConnect ion (String url , String drive rName , String user, String 
% passwd) throws SQLException, ClassNotFoundException 

0 Class . f orName (drive rName) ; 

~J return DriverManager . getConnection (url , user, passwd); 

p } 

AJ / * * 

y * execute an SQL query for the given connection 

a */ 

public static ResultSet executeSelect (String query, Connection connection) throws 
_ SQLException 

f| Statement statement = connection . createStatement () ; 

~ return statement . executeQuery (query) ; 

5 } 

1=57 /* * 

* execute an SQL Insert query for the given connection 
*/ 

public static boolean executelnsert (String query, Connection connection) throws 
SQLException 

{ 

Statement statement = connection . createStatement () ; 
return statement . execute (query) ; 

} 

I * * 

* execute a named stored procedure for the given connetion 
*/ 

public static boolean executeStoredProcedure (String sp, Object [] [] params , Connection 
connection) 

{ 

try 

{ 

Statement statement = connection . createStatement () ; 
ResultSet resultSet - null; 

StringBuffer query = new StringBuf f er ( ) ; 

query .append ( "EXECUTE " + sp + " " ) ; 



& 
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for (int i = 0; i < pa rams . length; 

{ 

if (params Ei3 [1] instanceof String) 

que ry. append ("@" + params[i][0] + " = ' M + params[i][l] + " 1 , " ) ; 
else if (params [i] [1] instancecf Integer) 

query .append ( "@" + params[i][0] + " = " + (( Integer) params [ i] [1] ) . 
intValue 0 + " , " ) ; 
else if (params [i] [1] instanceof Double) 

query .append ( "@" + paramsti] [0] + " = " + ( (Double ) params [i] [1]). 
doubleValueO + " , ") ; 
else if (params [i] [1] instanceof java . util . Date) 

query .append ( "@" + params [i] [0] + " = convert (datetime , 1 ft + ((java. util. 
Date) params [i] [1] ) . toLocaleString ( ) + " ' ) , " ) ; 

} 

String command = query . toString () ; 

command = command . substring ( 0 , command. length ( ) - 2 ) ; 

System. out ,println( "executing stored procedure: " + command); 

resultSet = statement . executeQuery (command) ; 

resultSet . close ( ) ; 
statement . close ( ) ; 

// close (); Need to copy the metaData, bug in jdbc:odbc driver, 
return true; 

} 

catch (SQLException ex) 
{ 

System. err .println (ex) ; 
return false; 

} 



/ * * 

^ * closed the passed connectoin 
Ti */ 

l2 public static void closeConnect ion (Connect ion connection) throws SQLException 

3 { 

connection . close () ; 

^ } 



♦ 



m 
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/ * * 

* @ (#) ApplicationConstants . java 
* 

* Copyright (c) 2000 ThinAirApps , Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF * 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 

public interface ApplicationConstants 

//Its important to define short variable names for use in content and URLs 
public final static String ACT I ON_ARG = "a"; 
public final static String APP_ARG = "ap" ; 



public final static String RELOAD_ACT I ON = "re- 
public final static String APP_ACTION = "a"; 
public final static String ME NU_ AC T I ON = "m" ; 
public final static String VIEW^ACTION = "v"; 
public final static String FORM_ACT I ON = "f"; 
public final static String INSERT_ACTION = "i" ,- 
public final static String UPDATE_ACTION = "u"; 



y public final static String KEY = "k"; 
li public final static String ITEM_ID = "i 



n 4 n . 



//some default values for use in initialization 

public final static String DEFAULT_APP_DIR = "Connectors\\WirelessForms\\apps" ; 
public final static String SUN__DB_DRIVER = " sun . jdbc . odbc . JdbcOdbcDriver " ; 
public final static String MS_DB_DRIVER = " com. ms . jdbc . odbc . JdbcOdbcDriver" ; 
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/ * * 

* @ {#) Application . java 
* 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 

* * 

* This class is the Java representation of the XML DTD used by 

* the Application Definitions Documents. The server parses the 

* XML document to create an instanceof this class per application. 
* 

*/ 

import java . util . Hashtable ,- 
import java .util . Enumeration; 

import j ava . sql . * ; 

public class Application 

{ 

;3S% //the application name 

~ private String m__name; 

Q //the Data Source Name and login and password for the DSN 

private String m_dsn; 

If private String m_login; 

b 2 private String m_pa s sword; 

J private String m_wf ormsURL ; 

: J //the store for all forms defined within an applicatoin 

^ private Hashtable forms; 

2 //the store for all views defined within an application 
™ private Hashtable views; 

3 //the JDBC Connection object used by each Application 
fi private Connection conn; 

I * * 

^ * ©param name the application name 

* ©param dsn the data source name 

* ©param login an authorized username for the DSN 

* ©param password a corresponding password for the login 
*/ 

public Application (String name, String dsn, String login, String password. String 
wf ormsURL) 

{ 

m_name = name ; 
m_dsn = dsn; 
m_login = login ; 
m_pas sword = password; 
m_wf ormsURL = wf ormsURL; 

forms = new Hashtable (); 
views = new Hashtable (); 

. } 

j * * 

* Set and store a JDBC Connection object within an Application instance 
* 

* ©param conn a JDBC Connection object 
*/ 

public void setConnection (Connection conn) 

{ 
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this. conn = conn; 

} 

/** 

* Return the current stored JDBC Connection 
* 

* ©return a JDBC Connection instance 
*/ 

public Connection getConnection () 

{ 

return conn; 

} 

public String getNameO 
{ 

return m_name ; 

} 

public String getDSNO 
{ 

return m_dsn; 

} 

public String getLoginO 

{ 

_ return m_login; 

!f } 

rt public String getPassword ( ) 

% { 

2z return m_password; 

F } 

.= public String getWFormsURL ( ) 

2 { 

=y return m_wf ormsURL ; 

} 

J public void addForm (WForm form) 
"5 forms, put (f orm. getName ( ) , form); 

fi > 

=? public WForm getForm (String name) 

= { 

return (WForm) forms . get (name) ; 

} 

public Enumeration getFormsO 

{ 

return f orms . elements () ; 



public void addView (WView view) 

{ 

views. put (view. getName () , view); 

} 

public WView getview (String name) 
{ 

return (WView) views . get (name) ; 

} 

public Enumeration getViews ( ) 

{ 

return views . elements () ; 

} 



#- m 
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I * * 

* @ (#) ApplicationRenderer . java 
* 

* Copyright <c) 2000 ThinAirApps, Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF * 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 

import java . sql .ResultSet ; 
/** 

* Interface used to build renderers for different markup languages and device types 

*/ 

public interface ApplicationRenderer 
{ 

/ * * - 

* Render all currently loaded applications in a selectable list 
* 

a * ©param apps a hashtable of Application objects 
t */ 

U public abstract String renderApplicat ions { java . util . Hashtable apps); 

1 / * * 

2 * Render a menu for a single Application that allows you to select WForms and WViews 
|= * 

y * ©param app an Application instance 
'Jl */ 

._T public abstract String renderMenu (Application app) ; 
I * * 

* Render a JDBC ResultSet for a particular Application and a particular WView 
— * 

fj * ©param app the application the WView is from 

□ * ©param view the WView the ResultSet was generated from 

* ©param resultSet the resultSet generated from a view and its SQL query 
~ */ 

=^ public abstract String renderView (Application app, WView view, ResultSet resultSet) ; 
/ * * 

* Render a particular application's form 

* ©param app the application the WForm is a part of 

* ©param form the WForm to render 
*/ 

public abstract String renderForm (Application app, WForm form) ; 
/ * * 

* Render a confirmation message with a link to a specific URL 
* 

* ©param app the Application the confirmation is for 

* ©param title the title to display for the confirmation 

* ©param message the confirmation message to display 

* ©param url the url to provider a link to 

*/ 

public abstract String renderConf irmat ion (Application app, String title, String message 
, String url) ; 
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Tic Tac Toe Sample Connector 
wireless SDK for ThinAir server 



About this Sample 

This sample connector demonstrates a simple game that can be implemented using 
the SDK. The tic-tac-toe game is always between the user and the connector 
logic. Alternating games have alternating players starting. All HTML and wml 
devices are supported by this connector. 

This connector also makes use of session objects. For more information on using 
sessions, see the sessionManagement sample connector in this directory and the 
corresponding ThinAir Server API documentation. 



Requi rements 



This sample requires the following SDK JARs: 
O * platform. jar 
;Jf * taglib.jar 
sji * devices. jar 

,fhis sample does not require any other external APIs. 



, ample Files 



Jjhis sample consists of the following file tree: 
connector.ini - connector configuration file 
TicTacToeconnector. jar - compiled Java code 

/src - java source files - Profileconnector. java and profileData. java 



Building the Sample 



Compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your classpath. 

install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir server's /Connectors subdirectory, given a name 
of your choice. 

in order to display the images, the GIF files must be placed into a 
"tictactoeconnector" directory under htdocs in the Thi nAi rServer directory, 
(ie: /program files/thinai rapps/thinai rserver/htdocs/ti ctactoeconnector) 

Start the ThinAir Server, it will load the sample code and begin executing it. 



Using the Sample 



wait until the Thi nAi rserver has started and the Tic Tac Toe Connector has been 
loaded and initialized. From your HTML or WML device, enter the IP address 
listed as the value for Appl i cati onPath in connector.ini (your Thi nAi rServer IP 
address), followed by /samples/tictactoe. For a machine with IP address 
111.222.12.34 this would be: 
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README . tXt 

http : //111 . 222 . 12 . 34/sampl es/ti ctactoe 
Follow the on-screen instructions. 



Last updated: 11.13.2000 
copyright 1999, 2000 ThinAirApps inc. 



ij 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//core ThinAir Server API functionality 
import com . thinairapps . platform . connector - * ,- 
import com . thinairapps . platform . device . * ; 
import com. thinairapps. plat form, except ion. * ,- 

//rendering packages used to build markup 
import com . thinairapps . tag . * ; 
import com . thinairapps . tag . html . * ; 
import com. thinairapps . tag . wml . * ,- 

//Core Java API 
import j ava . ut i 1 . * ; 
import j ava . io . * ; 



* This sample Connector demonstrates a simple interactive application that can be created 

using the 

* ThinAir API . The Connector plays Tic Tac Toe against the user, and works on all HTML and *r 
% WML 

^* devices. The TicTacToeBoard class, contained in TicTacToeBoard. java, contains all the *r 
B logic for 

. j * t he board itself, and the game rules. The main class, TicTacToeConnector , contains the * 
^ logic for 

* playing strategy, the game flow, and the screen display. 
J*/ 

-.public class TicTacToeConnector implements Connector { 

p~? //The friendly name of this sample app 

_ String appName; 

□ String path; 

fk Properties props; 

^ //Our access point to the services of ThinAir Server 

11 ConnectorAccess access; 

//points to the directory for images 
^ private final static String I MAGE_PATH = " /docs/tictactoeConnector/ " ; 

Integer GameState; 

final Integer IN_PROGRESS = new Integer (1) ,* 
final Integer USER_WON = new Integer (2); 
final Integer CONNECTOR_WON = new Integer (3); 
final Integer TIE_GAME = new Integer(4); 



/**init() is called by the ThinAirServer when the Connector is loaded. It provides the ^ 
Connector 

* with resources it needs to interact with the ThinAirServer. 
★ 

* ©param applicat ionName is a String derived from connector.ini. We don't need this fortf 

this sample. 

* ©param appl icationPath is a String dervid from connector.ini. We don't need this for ^ 

this sample. 

* ©param connectorProps is a Properties list containing developer assigned * 

connector- specif ic properties. 

* We don't need this parameter in this sample. 

* ©param connectorAccess is our access point to the services provided by ThinAir Server \£ 

We don ' t need 

* this for this sample. 

* ©param ApplicationLog is used for Logging. It is not used in this sample 
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*/ 

public void init (String applicationName , String applicationPath, Properties 
connect or Props , 

ConnectorAccess connectorAccess, ApplicationLog al) 

{ » 

appName = applicationName; 
path = applicationPath; 
props = connectorProps ; 
access = connectorAccess; 

} 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer / 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile 1 s getNameO method. 

* ^ 

* For more details about device detection and handling see the DeviceDetective sample * 

connector and the 

* ThinAir Server Developer Guide. 
* 

* ©return an array of Strings representing the friendly names of the devices this / 

Connector supports. 

*/ 

public String [] getDevicesO 
{ 

String deviceTypes [] = { " TA_HTML " , "TA_WAP n } ; 
return deviceTypes; 

} 



/**The handle method implements the core logic of a Connector. It takes an incoming wf 
request from a 

* particular device, and returns an appropriate response. This method is called whenever/ 

the server 

* receives a request from a type of device that the Connector indicates it supports, / 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of / 

the Connector 

* to interpret the request and generate an appropriate response. 
* 

* The server will pass a Device object containing as much information as possible into 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed / 

information 

+ on the capabilities of the particular device making the request. 
* 

* ©param props a. set of name value pairs corresponding to the HTTP request parameters / 

from the device. 

* ©param device a Device object created in the image of the actual device making this / 

request . 

* ©param result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle ( Properties props, Device device, OutputStream out) throws IOException 
{ 

String resultString ; 
this. props = props; 

//we name the sessionID param " sid" 

String sessionID = props . getProperty ( " sid" ) ; 



• # 
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//the cache for this session 
Hashtable cache = null; 

TicTacToeBoard theBoard = null; 
Integer GameState = null; 

char StartingPlayer, SecondPlayer ; 

//if this is the user's first hit, they will not yet have a session 
if (sessionID == null) 

//so create one for them 

sessionID = access . createSession () ; 



try 

//get the cache for this session. . . 

cache = access .getSessionCache (sessionID) ; 

catch (NoSuchSessionException e) 

// do nothing 



if (cache == null) 

// create a new board 
theBoard = new TicTacToeBoard ( ) ; 
theBoard. init () ; 
GameState = IN_PROGRESS; 

else if (cache . get ( "board" ) — null) 

// create a new board 
theBoard = new TicTacToeBoard ( ) ; 
theBoard. init ( ) ; 
GameState = IN_PROGRESS; 

else 

theBoard = (TicTacToeBoard) cache . get ( "board" ) ; 
GameState = ( Integer) cache . get ( "GameState " ) ; 



playTurn (sessionID, theBoard) ; 
cache. put ( "board" , theBoard) ; 
try { 

// determine which device is contacting the Connector and use a different 
// rendering class to generate output 
if (device instanceof HTMLDevice) 

resultString = HTMLDisplayScreen ( sessionID, theBoard) ; 

else if (device instanceof PalmVIIDevice) 

resultString = HTMLDisplayScreen ( sessionID, theBoard) ; 

else if (device instanceof WAPDevice) 

resultString = WMLDisplayScreen ( sessionID , theBoard) ; 

else if (device instanceof UPWAPDevice) 

resultString = WMLDisplayScreen ( sessionID, theBoard); 

else if (device instanceof GoWebRIMDevice) 
resultString = WMLDisplayScreen (sessionID, theBoard) ; 

else 

resultString = "ERROR: Device "+device .getClass ( ) + " not supported. 1 '; 
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} catch (Exception e) { 
e .printStackTrace ( ) ; 

resultString = "ERROR: " + e .getMessage { ) ; 

} 

out.write(resultString.getBytes() ) ,- 



/ * * 

* MakeMove ( ) decides on the next move for the computer to make, and changes the board to 

* reflect that move. 
* 

* ©param theBoard the current state of the board 
*/ 

private void makeMove (TicTacToeBoard theBoard) 

{ 

Random randGen = new Random ( ) ; 
int randCell, randRow, randCol; 

int rowCount , colCount ; 

//look for a winning move... 

for (rowCount = 0; rowCount < theBoard . NUM_ROWS ; rowCount++) { 

for (colCount = 0; colCount < theBoard .NUM_COLS ; colCount++) { 
if (theBoard. emptyAt (rowCount, colCount)) { 

theBoard. placePiece ( 'O' , rowCount, colCount) ; 
if ( theBoard. playerWon { 'O' ) ) { 

return; 
} else { 

theBoard . placePiece ( theBoard . EMPTY_S PACE , rowCount , colCount ) ; 

} 

} 

} 

} 



lj //Barring that, block user from any winning moves.. 

□ for (rowCount = 0; rowCount < theBoard. NUM_ROWS ; rowCount++) { 

^ for (colCount = 0; colCount < theBoard .NUM_C0LS ; colCount ++) { 

if ( theBoard . emptyAt ( rowCount , colCount)) { 

theBoard . placePiece ( 1 X * , rowCount , colCount ) ; 
if ( theBoard. playerWon ( 'X 1 ) ) { 

theBoard. placePiece ( 'O' , rowCount, colCount) ; 
return ; 
} else { 

theBoard . placePiece ( theBoard . EMPTY_S PACE , rowCount , colCount ) ; 

} 

} 

} 

} 



//Otherwise, enter piece in a randomly- chosen cell (of the ones that haven't been 
//filled already 
do { 

randCell = Math . abs ( randGen . nextlnt ( ) % ( theBoard . NUM_COLS * theBoard . NUM_ROWS) ) ; 
randRow = randCell / theBoard .NUM_ROWS ; 
randCol = randCell % theBoard . NUM_COLS ; 

} 

while (! theBoard . emptyAt (randRow, randCol)); 
theBoard. placePiece ( ' O' , randRow, randCol) ; 
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/ * * 

* HTMLDi splay Board ( ) returns the HTML version of the board in its current state. 
* 

* ©param sessionID the current session ID 

* ©param theBoard the current state of the board 

* ©param GameOver whether or not the game is over and further clicking should be 

* disabled 
* 

* ©return an HTML table, containing a graphical representation of the board 
*/ 

public com. thinairapps . tag .html .Table HTMLDi splayBoard (String sessionID, TicTacToeBoard 
theBoard, 

boolean GameOver) { 

com. thinairapps . tag .html .Table TTTTable = new com. thinairapps . tag . html . Table (1 ) ; 
com . thinairapps . tag . html . TableCell 

Cell[][3 = new com . thinairapps . tag . html . TableCell [theBoard .NUM_ROWS] [theBoard. kf 
NUM_COLS] ; 
com . thinairapps . tag . html . TableRow 

Row[] = new com . thinairapps . tag . html . TableRow [theBoard . NU£1_R0WS] ; 

int rowCount , col Count ,- 
char curPiece; 

for (rowCount = 0; rowCount < theBoard . NUM_ROWS ; rowCount++) { 

Row [rowCount] = new com. thinairapps . tag . html . TableRow () ; 
TTTTable . addChild (Row [rowCount] ) ; 

for (colCount = 0; colCount < theBoard -NUM_COLS ; colCount++) { 

Cell [rowCount] [colCount] = new com. thinairapps . tag . html . TableCell () ; 
Row [rowCount] . addChild (Cell [rowCount] [colCount] ) ; 



if (theBoard. emptyAt (rowCount , colCount)) { 
if (GameOver) { 

Cell [rowCount] [colCount] .addChild 

(new com. thinairapps . tag. html . Image (IMAGE_PATH + "ttt -blank, 
gif ") ) ; 

} else { 

Cell [rowCount] [colCount] .addChild 

(new Hyper linkedlmage (path + "?row=" + Integer . toString 
( rowCount ) + 

"&col=" + Integer . toString (colCount) + "&sid=" + sessionID, 
IMAGE_PATH + " ttt-blank . gif » ) ) ; 

} 

} else { 

curPiece = theBoard . pieceOccupying ( rowCount , colCount); 
if (curPiece == 'X') { 

Cell [rowCount] [colCount] .addChild 

(new com . thinairapps . tag . html . Image ( IMAGE_PATH + " ttt-x.gif " ) ) 
} else if (curPiece == 'O') { 

Cell [rowCount] [colCount] .addChild 

(new com. thinairapps . tag . html . Image (IMAGE_PATH + " ttt-o . gif " ) ) 

} 



} 

return TTTTable ; 
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* This method renders an HTML page showing the board in its current state, along with * 

the title, 

* and other explanatory information 
* 

* ©return the rendered HTML page. 
*/ 

private String HTMLDisplayScreen (String sessionID, TicTacToeBoard theBoard) 
{ 

String resultString; 
Body body - new Body ( ) ; 

HTMLTagDocument HTMLDoc = new HTMLTagDocument ( ) ; 
Title theTitle = new Title ("Play Tic Tac Toe ! " ) ; 

7/the cache for this session 
Hashtable cache = null; 

try 
{ 

//get the cache for this session... 
cache = access .getSessionCache ( sessionID) ; 
} catch (NoSuchSessionException e) { } 

Character SecondPlayer = (Character) cache . get { "SecondPlayer" ) ; 
Integer GameState = (Integer) cache .get ( "GameState" ) ; 

boolean GameOver = (GameState == USER_WON | | GameState == CONNECTOR_WON | | GameState X 
= = TIE_GAME) ; 

//set the background color 

body . addAt t r ibu t e ( " bgcol or « , " # f f f f f f " ) ; 

//add a title 

body.addChild(new com. thinairapps . tag . html . Bold ( " Play a game of Tic Tac Toe")) ; 
body .addChild(new HorizontalRule ( ) ) ; 

body. addChi Id (HTMLDi splay Board (sessionID, theBoard, GameOver)) ; 

if (GameState == USER_WON) { 

body.addChild(new com. thinairapps . tag . html . Bold ( "You win! " ) ) ,- 
} else if (GameState == CONNECTOR_WON) { 

body .addChild(new com. thinairapps . tag . html . Bold (" I win! " ) ) ; 
} else if (GameState « TIEJ3AME) { 

body . addChild (new com. thinairapps . tag . html . Bold ( "It 1 s a tie! " ) ) ; 

} 

body . addChild (new com. thinairapps . tag .html . Text ( "Play a ")); 

body. addChild (new com. thinairapps . tag . html .Anchor ( " " , path + " ?action=clear&sid- " + ^ 
sessionID, 

new com. thinairapps . tag .html . Text 
( " new game " ) ) ) ; 

HTMLDoc. addChild (theTitle) ; 
HTMLDoc . addChild (body) ; 

resultString - HTMLDoc . render ( ) ; 

return resultString; 



/ * * 

* WMLDi splay Board ( ) returns the WML version of the board in its current state. 

* ©param sessionID the current session ID 

* ©param theBoard the current state of the board 
* 

* ©return an HTML table, containing a graphical representation of the board 
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*/ 

public com. thinairapps . tag. wml .Table WMLDi splay Board (String sessionID, TicTacToeBoard «r 
theBoard) 

{ 

com. thinairapps . tag .wml .Table 

TTTTable = new com. thinairapps . tag .wml .Table ( "Board" , "ALIGN_LEFT M , 3) ; 

com. thinairapps . tag .wml .TableCell 

Cell[][] = new com. thinairapps . tag .wml .TableCell [theBoard. NUM_ROWS] [theBoard. 
NUM_COLS] ; 

com . thinairapps . tag . wml . TableRow 

Row[] = new com. thinairapps . tag .wml .TableRow [theBoard. NUM_ROWS] ,- 

int rowCount , colCount ; 
char curPiece; 

Random randGen = new Random ( ) 

// append a random number to combat caching 

int randNum = Math . abs (randGen . next Int ( ) % 10000); 

for (rowCount = 0; rowCount < theBoard . NUM_ROWS ; rowCount++) { 

□ Row [ rowCount ] = new com . thinairapps . tag . wml . TableRow () ; 

S TTTTable .addChi Id (Row [rowCount] ) ; 

S for (colCount = 0; colCount < theBoard .NUM_C0LS / colCount++) { 

1= Cell [rowCount] [colCount] = new com. thinairapps . tag .wml . TableCell () ; 

Row[rowCount] .addChi Id (Cell [rowCount] [colCount] ) ; 

sj 

*J curPiece = theBoard . pieceOccupying (rowCount , colCount); 

™ if (curPiece == theBoard. EMPTY_SPACE) { 

Cell [rowCount] [colCount] .addChild 
lj (new com.: thinairapps. tag. wml. Image (IMAGE_PATH + " /ttt-blank . 

jl gif", "?")); 

} else if (curPiece == 'X') { 
if Cell [rowCount] [colCount] .addChild 

|1 (new com. thinairapps . tag .wml . Image (IMAGE_PATH + "/ttt-x.gif n , "X" )); 

2 } else if (curPiece == '0') { 

L Cell [rowCount] [colCount] .addChild 

(new com. thinairapps. tag. wml. Image (IMAGE_PATH + "/ttt-o.gif " , "O")); 

} 

} 

} 

return TTTTable; 

} 



/* ★ 

* This method renders a WML page showing the board in its current state, along with the * 

title, 

* and other explanatory information 
* 

* ©return the rendered WML page. 

private String WMLDisplayScreen (String sessionID, TicTacToeBoard theBoard) { 
String resul tString ; 

DisplayCard theCard = new DisplayCard ( "cl " ) ; 
WMLTagDocument deck = new WMLTagDocument ( ) ; 

Random randGen = new Random ( ) ; 

int randNum = Math . abs ( randGen . next Int ( ) % 10000); 
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//the cache for this session 
Hashtable cache = null; 

try 
{ 

//get the cache for this session. . . 
cache = access .getSessionCache (sessionID) ; 

catch (NoSuchSessionException e) { } 

Integer GameState = ( Integer) cache . get ( "GameState" ) ; 

com. thinairapps . tag .wml . Paragraph p = new com . thinairapps . tag . wml . Paragraph () ; 
p.addChild(WMLDisplayBoard(sessionID, theBoard) ) ; 

if (GameState == USER_WON) 

p.addChild(new com. thinairapps . tag . wml . Text ( "You win! ")); 

lse if (GameState == CONNECTOR_WON) 

p.addChild(new com. thinairapps . tag . wml . Text (" I win! ")); 

else if (GameState == TIE_GAME) 

p.addChild(new com . thinairapps . tag . wml . Text (" It • s a tie! ")); 

ilse 

// the game is still in progress, let the user select the next move 
V= p.addChild(new com . thinairapps . tag . wml . Text ( "Enter the cell # for your next move 

.£ : ")); 

int rowNum, colNum; 
W String cellNumString; 

-J for (rowNum = 0; rowNum < theBoard . NUM_ROWS ; rowNum+ + ) { 

for (colNum = 0; colNum < theBoard. NUM_COLS; colNum++) { 
if (theBoard. emptyAt (rowNum, colNum)) { 
; cellNumString = Integer . toSt ring ( (rowNum * theBoard . NUM_COLS ) + * 

\Zi colNum + 1) ; 

if; p.addChild(new com. thinairapps . tag . wml .Anchor (path + "?row=" + 

:Lj Integer . toString (rowNum) + 

M "&col=" + Integer . toString (colNum) + 

j f\ " &amp ; rnd= 11 + randNum + " &amp ; s id= " + 

js=t sessionID, " " , 

-Tfiew com. thinairapps . tag .wml . Text (cellNumString) )) ; 
I* } 
} 

} 

} 

p.addChild(new com. thinairapps . tag .wml .Anchor (path + " ?action=clear&amp ; rnd= " + * 
randNum + 

M & sid=" + sessionID, "" , 
new com. thinairapps . tag .wml .Text ( "Play >£ 
a new game " ) ) ) ,- 

theCard.addChild(p) ,* 
deck.addChild(theCard) ; 
resultString - deck . render () ; 
return resultString; 

} 

private void playTurn (String sessionID, TicTacToeBoard theBoard) 
{ 

Character StartingPlayer , SecondPlayer ; 
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//the cache for this session 
Hashtable cache = null; 

try 

{ 

//get the cache for this session. . . 

cache - access .getSessionCache ( sessionID) ; 

catch (NoSuchSessionException e) { } 

Integer GameState = ( Integer ) cache . get ( "GameState ") ; 

// did the user just enter a move? 

if (props -get Property ( "row" ) != null) { 

int rowNum = Integer . parselnt (props .getProperty (" row" )) ; 
int columnNum = Integer .parselnt (props .getProperty ( "col ")) ; 

// is the move valid? 

if (theBoard. emptyAt (rowNum, columnNum)) { 

theBoard. placePiece { 1 X ' , rowNum, columnNum) ; 

if ( theBoard. playerWon( 'X' ) ) { 

GameState = USER_WON; 
} else if ( theBoard. boardFull () ) { 

GameState = TIE_GAME; 
} else { 

//GameState = ( Integer) cache .get ( "GameState ") ; 
makeMove (theBoard) ; 

if ( theBoard. playerWon ( 'O' ) ) { 

GameState = CONNECTOR_WON; 
} else if ( theBoard. boardFull () ) { 

GameState = TIE_GAME; 

} 



// if it's not a valid move, do nothing 

// if no move was entered, clear the board and start a new game 
else { 

GameState = IN_PROGRESS ; 
theBoard . init ( ) ; 

if (cache .get ( "SecondP layer" ) != null) { 

StartingPlayer = (Character ) cache .get ( "SecondPlayer ") ; 
} else { 

StartingPlayer = new Character (' X ') ; 

} 

if (StartingPlayer . charValue ( ) == 'X') { 

SecondPlayer = new Character (' 0 ') ; 
} else { 

SecondPlayer = new Character (• X ') ,- 

} 

"cache. put ("StartingPlayer" , StartingPlayer) ,- 
cache . put ( " SecondPlayer" , SecondPlayer) ; 

if (StartingPlayer . charValue ( ) == '0') { 
makeMove (theBoard) ; 

} 
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} 

cache .put ( "GameState" , GameState) ; 

} 



/ * * 

* This is a simple exception rendering method. 
* 

* ©param message. the message to be presented to the user 

* ©return the rendered HTML page deck 
*/ 

private String renderException (String message) 

{ 

//create the page 

HTMLTagDocument page = new HTMLTagDocument ( ) ; 

Body body = new Body ( ) ; 

//set the background color 

body. addAttribute ( "bgcolor" , "#f fffff ") ; 

body.addChildtnew com. thinairapps . tag .html - Text (message) ) ; 
body .addChild(new com. thinairapps . tag . html . Break ( ) ) ; 

O String resultString = body . render () ,- 

,S return resultString; 

H ) 
2 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

import java.util.*; 
import j ava . io - * ; 

class TicTacToeBoard extends Object 
{ 

final int NUM_ROWS = 3; 
final int NUM_COLS = 3; 
final char EM PT Y_S PACE = ■ ?■; 

//The board is represented as an array of characters 
private char PieceAt [] [] = new char [NUM_ROWS] [NUM_COLS] ; 

//Set each cell in the board to be blank 
public void init ( ) 

{ 

int rowCount , colCount ; 

for (rowCount = 0; rowCount < NUM_R0WS ; rowCount++) 
% for (colCount = 0; colCount < NUM_COLS; colCount++) 

0 PieceAt [rowCount] [colCount] = EMPTY__SPACE ; 

H } 
E } 

ri } 



z* * 

* Returns the character occupying the cell at row number rowNum 
3 * and column number columnNum 

«=• public char pieceOccupying ( int rowNum, int columnNum) 

s { 

It return PieceAt [rowNum] [columnNum]; 



* Returns whether the cell at row number rowNum and column 

* number columnNum is empty 
*/ 

public boolean emptyAt { int rowNum, int columnNum) 

return (PieceAt [rowNum] [columnNum] == EMPTY_SPACE) ; 

} 



/ * * 

* Inserts a piece of type player at the cell with 

* row number rowNum and column number columnNum 

*/ 

public void placePiece (char player, int rowNum, int columnNum) 

{ 

PieceAt [rowNum] [columnNum] = player; 

} 



/ * * 
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* Returns whether or not the board is completely 

* filled with pieces 
*/ 

public boolean boardFullO 

{ 

int rowCount, colCount; 

for (rowCount = 0; rowCount < NUM_R0WS; rowCount++) 

^ for (colCount = 0; colCount < NUM_COLS; colCount ++) 
{ 

if (PieceAt [rowCount] [colCount] == EMPTY_S PACE ) 
return false; 

} 

} 

return true; 

} 



/ * * 

* Returns whether or not the player using the character 

* 'player' (either X or O) has a straight line of pieces in some^ 

* direction on the board 

*/ 

W public boolean playerWon (char player) 

m { 

iw int rowCount, colCount; 

boolean Won; 

K p //Check for horizontal win 

i\ i for (rowCount = 0; rowCount < NUM_ROWS; rowCount + + ) 

'3 { 

XU Won = true; 

E for (colCount = 0; colCount < NUM_C0LS; colCount++) 

if (PieceAt [rowCount] [colCount] != player) Won = false; 
Q if (Won) return true; 

= =J //Check for vertical win 

!-i for (colCount = 0; colCount < NUM_C0LS; colCount+ + ) 

{ 

Won = true; 

for (rowCount = 0; rowCount < NUM_R0WS ; rowCount ++) 

if (PieceAt [rowCount] [colCount] != player) Won = false; 

} 

if (Won) return true; 

} 

//Check for diagonal win 
Won - true; 

for (rowCount = 0, colCount = 0; rowCount < NUM_ROWS ; rowCount++ , colCount++) 
{ 

if (PieceAt [rowCount] [colCount] != player) Won = false; 

} 

if (Won) return true; 
Won = true; 

for (rowCount = 0, colCount = NUM_COLS - 1; rowCount < NUM_R0WS ; rowCount++, 
colCount--) 

if (PieceAt [rowCount] [colCount] player) Won = false; 

} 

if (Won) return true; 
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return false; 



ft 



README . tXt 



webscraper Sample Application 
wireless SDK for ThinAir Server 



About This sample 



This sample application contains both a connector (simplewebconnector . java) and 
a Provider (SimplewebProvider . java) . These two pieces work together to combine: 

1. data access - via the ThinAir storeProvider API 
with 

2. device specific rendering - via the Device detection facilities in ThinAir 
Server and the markup generating Tag Libraries 

into one distributed solution. 

when you contact the Simplewebconnector with either a wireless device or web 
browser you will receive a ui asking for a URL. Enter a web address. The 
Connector will contact the SimplewebProvider to fetch the page. The 
SimplewebProvider will retrieve the web page, eliminate all markup and 
^Unprintable characters, and return the raw text to the Connector. The 
Connector will then render the page in approximately IK chunks to each device 
*Wn its own markup. You can scroll through the entire page, asking the 
ijgonnector for 'More 1 data via a link at the bottom of each screen. 



3SS 



iirfequi rements 



^jShis sample requires the following SDK jars: 
5 _ * platform. jar 
]£ * taglib.jar 
=«s * devices. jar 



Sample Files 

This sample consists of the following file tree: 

connector.ini - sample connector configuration file 
provider.ini - sample provider configuration file 

webscraper.html - a static html page that can be used by a Palm Pilot 
PQA 

webscraper . jar - compiled Java code 

/src - Java source files for both the Connector and Provider 



Building the sample 



compile the sample code using the Java compiler of your choice. Be sure to 
include the .jar files above in your CLASSPATH. 

install the Connector classes and connector.ini configuration file into a 
subdirectory of the ThinAir Server's /connectors subdirectory, given a name 
of your choice. 
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install the Provider classes and provider. im configuration file into a 
subdirectory of ThinAir Server's /Providers subdirectory, given a name of 
your choice. 

The webscraper root directory contains, for the sake of simplicity, a single 
webscraper. jar file containing all the classes used by either the Connector or 
the Provider (or both). Instead of dividing up the application into two sets of 
classes, you can run both connector and Provider by just placing a copy of this 
file in both directories. 

Start the ThinAir server, it should load SimpleWebConnector and 
Simpl ewebProvider and initialize both. 



using the Sample 



wait until the ThinAir server has started and both the connector and Provider 
have been loaded and initialized. From your wireless device, or web browser, 
enter the IP address listed as the value for ApplicationPath in connector.ini 
(your ThinAirserver IP address), followed by /samples/web. For a machine with 
IP address 111.222.12.34 this would be: 

http : //111 . 222 . 12 . 34/sampl es/web 

Follow the on-screen instructions. 

Supported devices include WAP phones, hdml phones, Palm Pilots, Windows CE 
devices, desktop web browsers, and GO America/GO rim papers, to create a PQA 
application for the Palm VII that integrates with the ThinAir Server, you 
'5/ill need to understand and use "web clipping," technology from Palm, web 
flipping involves essentially creating html interfaces into your applications. 
' For your convienence, an html file (webscraper.html) has been provided for 
!lthis purpose, to find out more about creating PQAs and web clipping 
^technology, visit: http://www.palmos.com/dev/tech/webclipping/ 



Last updated: 11.13.2000 
copyright 1999, 2000 ThinAirApps inc. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com. thinairapps . platform. * ; 
import com. thinairapps .plat form. device .* ; 

//Rendering packages used to build markup 
import com. thinairapps . tag .* ; 
import com . thinairapps . tag . wml . * ; 

//Core Java API 
import java.util.*; 



/ * * 

* @ ( # ) WMLRende r e r . j ava 
* 

* Utility class containing static methods for rendering output in wmj. 
*/ 

..public class WMLRenderer 

% i_J / * * 

eg * Generate a WML page with a GUI with which the user can enter a URL 

2 * ©param connectorName the name of the Connector 

* ©param path the HTTP path that maps to this Connector 
"'ll * ©param reqProps the parameters of the original request + the session identifier 
^ */ 

;! 2 public static String showURLInputUI (String connectorName, String path, Properties ^ 
reqProps) throws Exception 

{ 

WMLTagDocument deck = new WMLTagDocument () ; 
*fj SinglelnputCard card = new SinglelnputCard ( "url " , "Enter URL"); 

sis //Print the name of the Connector at the head of the card 

:U Paragraph p = new Paragraph (Paragraph .AL I GN_CENTER, Paragraph .MODE_WRAP) ; 

M p.addChild( new Text ( "Welcome to M +connectorName) ); 

p.addChild( new Break ( ) ); 

card.addChild (p) ; 

// Construct the request URL 
// action (a) == get 

// url (url) == $url (to be filled in by the WML input element) 
// page number (pn) == start with the first chunk of data 

// session ID (sid) == determined in Connector and passed in request props param 
StringBuf fer sb = new StringBuf f er ( 56 ) ; 
sb. append ( path ); 

sb. append ( " ?a=get&amp ;url=$ (url) &amp ; pn= 0 &amp ; sid= " ) ; 
sb.append( reqProps . getProperty (" sid" ) ); 
sb . append ( " &amp ; rnd= " ) ; 

//Append a random number to combat caching 
sb. append ( Math . random { ) ) ; 
String url = sb . toString ( ) . trim ( ) ; 

card. buildCard (url, "Enter URL: "url", " * " + Input . FORMAT_ANY__L CAS E_CHANGE ABLE ); 

deck . addCard (card) ; 



return deck . render () ; 
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/** 

* Generate a page displaying a portion of the requested web page 
* 

* ©param connectorName displayed at the top of the page 

* ©param path used to issue another request 

* ©param reqProps the properties of the original HTTP request 

* ©param page the actual page text 

* ©param more indicates whether any more data is available 
*/ 

public static String showURLOutput (String connectorName, String path, Properties reqProps* 

String page, boolean more) 

String sessionID = reqProps . getProperty ( " sid" ) ; 
String url = reqProps . getProperty ( "url " ) ; 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

DisplayCard card = new DisplayCard ( "page" , connectorName); 

Paragraph p = new Paragraph (Paragraph. ALIGN_CENTER, Paragraph . MODE_NOWRAP) ; 
p.addChild( new Text (url) ); 
card.addChild(p) ; 

p = new Paragraph (Paragraph .AL I GN_LE FT, Paragraph . MODE_WRAP) ,- 
p.addChild( new Text (page) ); 
p.addChild( new Break () ); 

//If there is more text to display, add an anchor to request the next IK 
StringBuffer sb; 

if (more) 

int pn = Integer .parselnt ( reqProps .getProperty ( "pn" ) ) ,- 

//Build the request url 

sb = new StringBuf fer ( 56 ) ; 

sb. append (path) ; 

sb. append (" ?a=ge t &amp ; ur 1 =") ; 

sb. append ( url ) ,* 

sb . append ( " &amp ; pn= " ) ; 

//Increment the page number 

sb. append ( String .valueOf ( ++pn ) ); 

sb . append ( " &amp ; s id= " ) ; 

sb. append ( sessionID ) ; 

sb . append ( " &amp ; rnd= " ) ,- 

//Append a random number to combat caching 
sb . append (Math . random ( ) ) ; 

String href = sb . toString ( ) . trim ( ) ; 

Anchor anchor = new Anchor ( new Gofhref, false), new Text ("More") ) ; 
p . addChi Id (anchor) ; 

} 

card.addChild(p) ; 



//Create a back button to take use back to the request page 
sb = new StringBuf fer (56 ) ; 
sb . append (path) ; 

//Append an empty action (a) so that the Connector returns the input page 
sb . append (" ?a= &amp ,- sid= " ) ; 
sb . append (sessionID) ; 
sb . append ( " &amp ; rnd= 11 ) ; 
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//Append a random number to combat caching 
sb . append (Math . random ( ) ) ; 

Do button = new Do (Do . TYPE_ACCEPT, new Go ( sb . toString ( ) . trim ( ) , false )); 
button.addAttribute ("label", "Back") ; 
card. addChild (button) ,- 

deck.addChild(card) ; 

String s = deck . render ( ) ; 



* ©param e Exception which you wish to render 
*/ 

public static final String renderExcept ion (Exception e) 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( "Error " , "Error"); 

card. buildCard ( "Error : "+e .getMessage ( ) , Paragraph .AL I GN_LE FT) ; 

deck . addCard (card) ; 
return deck . render () ; 



return s ; 



I * * 

* Generate a page describing an error that has occured 



* 




C: \TASS\ . ■ \Applications\WebScraper\src\WebProviderResult . java 

/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com . thinai rapps . plat form . * ; 
import com . thinairapps . platform . provider . * ; 
import java.util.*; 



/** 

* @ (#) WebProviderResult . java 
* 

* This object is generated on the Provider to contain the results of a 

* web page query. The Connector unwraps it and displays the returned text 
*/ 

public class WebProviderResult extends Storeltem 

{ 

private String pageText; 
/ * * 

_ * Create a new WebProviderResult containing the processed text from a web page 
?0 * ©param String text 

in */ 

- public WebProviderResult (String text) 
t < 

super () ; 
hi pageText = text; 

H > 

Vfj. 

3 / * * 

2*=h * ©return String the processed web page text 
*/ 

\12 public String getTextO 
tf% return pageText; 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 



//Core Java API 
import j ava . net . * ; 
import java.util.*; 
import j ava . io . * ; 



* @ (#) urlTool . java 
* 

* This utility processes an HTML page and removes all markup 
*/ 

public class urlTool 

^ private final static String SPECIAL_CHARS [] = { n  ", 

" &amp ; " , 
"&#174", 
"& 
M &#183 
". 
"&", 

;S M $" }, 



j * * 

* Format a url to begin with http if it doesn't already then call process page 
*/ 

public static String getPageAndProcess (String page, int skipLines) 



{ 



if { !page.toLowerCase() . start sWith { "http ://" ) ) 
page = "http://" + page; 

return processPage (getPage (page ) , skipLines) ; 



* Remove all markup from a page and return it 



* ©param pageText - HTML contents 

* ©param skipLines - return everything after this many lines 
*/ 

protected static String processPage (String pageText, int skipLines) 



{ 



pageText = remove JS (pageText ) ,- 
pageText = removeTags (pageText) ; 
pageText = removeBlankLines (pageText ) ; 
pageText = removeSpecial (pageText) ; 



return pageText ; 



/ * * 

* Format a url to begin with http if it doesn't already 
*/ 

protected static String checkURL (String page) 

if (! page . toLowerCase (). startsWith ( "http: //") ) 
page = "http://" + page; 

return page; 
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} 



/ * * 

* Remove all blank lines and new lines 
* 

* ©param text source String 
*/ 

protected static String removeBlankLines (String text) 
{ 

StringBuffer output = new StringBuf f er ( ) ; 
StringTokenizer st = new StringTokenizer (text , "\n" ) ; 
String line; 

if ( ! st .hasMoreTokens ( ) ) 
{ 

output . append (text ) ; 

} 

else 

{ 

while (st .hasMoreTokens ( ) ) 
{ 

line = st . nextToken ( ) ; 
line = line . trim () ; 

if (line. length {) > 0) 

output . append (line + "\n"); 



return output . toString () ; 



/ * * 

* Remove all script tags from HTML 
* 

* ©pararn htmlCode source HTML 
*/ 

protected static String removeJS (String htmlCode) 

htmlCode = r emoveTag Pa irCont en t (htmlCode , '^script", " </script>" ) ; 
htmlCode = removeTagPairContent (htmlCode , "<!-", "->"); 

return htmlCode; 

} 



/** 

* Remove pairs of opening and closing tags 
*/ 

protected static String removeTagPairContent (String htmlCode, String start, String end) 
{ 

int i - 0 ; 

int endldx = 0 ; 

while ( (i ~ htmlCode . indexOf ( start , i) ) > 0) 

{ 

endldx = htmlCode . indexOf ( end, i ) ; 
if (endldx == -1) 
break; 

htmlCode = htmlCode . substring ( 0 , i ) +html Code . substring (endldx+end . length () , 

htmlCode . length ( ) ) ; 
i = htmlCode . indexOf ( start , i) ; 

} 
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return htmlCode; 

} 



/ * * 

* Remove the text specified in SPECIAL_CHARS 
*/ 

protected static String removeSpecial (String htmlCode) 
{ 

int numSpecial = S PEC I AL_CHARS . length ; 
int indexes [] = new int [numSpecial] ,- 

int len = htmlCode . length () ; 
int newLen = len; 

char dummy = (char) 0; 

char buf [] = htmlCode . toCharArray ( ) ; 

int i , j , k, index; 

outer: 

while (true) 

{ 

// Count how many SPECIAL_CHARS have been found 
k - 0; 



// Look through all the SPECIAL_CHARS 
for (i = numSpecial; --i >= 0; ) 

{ 

//No more SPECIAL to be found 

if (indexes [i] == -1) 

{ 

// Have ALL SPECIAL been found? 
if (++k == numSpecial) 
break outer; 

//Skip and keep LOOKING 
else 

continue inner; 

} 

else 
{ 

//Look for more of SPECIAL 

index = htmlCode . indexOf ( SPECIAL_CHARS [i] , indexes [i] ) ; 

//No more SPECIAL 
if (index = = -1) 

{ 

//Mark as all done 
indexes [i] = index ; 

//Continue to next 
continue inner ; 



// Replace all chars in SPECIAL with dummy char 
for (j = SPECIAL_CHARS [i] .length () ; --j >= 0; ) 
{ 

buf [ index + j ] - dummy; 
- -newLen; 
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} 

//Advance indexes [i] to avoid repeats 
indexes [i] = index + 1; 

} 

} 



StringBuffer sb = new StringBuf fer (newLen) ; 

//Copy all non-dummy chars into the return array 
for (i = 0; i < len; i++) { 
if (buffi] == dummy) 
continue ; 

else 

sb . append ( buf [ i ] ) ; 

} 

return sb . toString ( ) . trim ( ) ; 



I * * 

* Remove anything that starts with a < and ends with a > 
* 

* ©param html Code source HTML 
*/ 

protected static String removeTags (String htmlCode) 

{ 

StringBuffer results = new StringBuf fer () ; 
StringTokenizer st = new StringTpkenizer (htmlCode ,"<") ; 
String text = null; 
while ( st . hasMoreTokens ( ) ) 

{ 

text = st .next Token () ; 

text = text . substring (text . indexOf (">") +1) ; 

if (text .length () > 0 && ! text . equals ( "\n" ) && ! text . equals ( " ")) 
results . append (text + M " ) ; 

} 

return results . toString () ; 

} 



I -k * 

* Fetch a page and return it 
*/ 

protected static String getPage (String urlString) 
{ 

try 

URLConnection uc = new URL (checkURL (urlString) ) . openConnection ( ) ; 
return getStringFromStream (uc . getlnputStream ( ) ) ; 

} 

catch (Exception e) 

{ 

e . printStackTrace ( ) ; 
return null; 

} 

} 
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* Read a page from an input stream 
*/ 

protected static String getStringFromStream ( inputStream is) throws Exception 
^ StringBuffer sb = new StringBuff er ( 50000 ) ; 

Buf f eredReader br = new Buff eredReader (new InputStreamReader ( is ) ) ; 

String line = br . readLine () ; 

while (line != null) 

sb . append (line + "\n" ); 
line = br . readLine () ; 

return sb . toString ( ) . trimO ; 



/ * * 

_ * Skip this number of lines into the page 
? */ 

□ protected static String skipLines (String page, int lines) 

0 { 

_"= if (lines == 0) return page; 

P StringTokenizer st = new StringTokenizer (page , " \n" ) ; 

1 if (st . countTokens ( ) > lines) 

t i 

y page = " " ; 

for (int i = 0; i < lines; i + + ) 
jr st . next Token ( ) ; 

j while (st .hasMoreTokens () ) 

r~ page = page + st . nextToken ( ) + "\n" ; 

3 } 

4= return page; 

} 

} 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality- 
import com. thinairapps .plat form. provider . * ; 
import com. thinairapps .platform. exception. * ; 

//Core Java API 
import java.util . * ; 



J * * 

* @ {#) SimpleWebProviderContext 
* 

* Provides static information for and about the Simple Web Provider 
* 

*/ 

public class SimpleWebProviderContext extends StoreProviderContext 
public static final short WEB_PROVIDER_RESULT = 125; 



// Version information 

protected static final String VERSION 
protected static String APP_NAME 
protected static final String MANUF_NAME 
protected static final String MANUF_CONT 
protected static final String BUILD 
protected static final Date APP_RELEASED 



"1.2" ; 

"WebScraper" ; 
"ThinAirApps" ; 
"www . ThinAirApps . com" 
" 1 " ; 

new Date ( ) ; 



private Properties props; 



/ ** 

* Determines if the context has optional user-editable properties. Implementors should 

* return true if they can offer optional Properties to the user, but do not require 

these 

* properties to be set in order to correctly serve user connections. StoreProviders may^ 

have 

* both property types . 
* 

* ©return A boolean indicating whether or not the context has optional properties. 
*/ 

public boolean hasOpt ionalProps ( ) 

{ 

return false; 

} 



/** 

* ©return ProviderObj ectSet indicating the friendly and class names of Storeltem 

subclasses 

* understood by this StoreProvider . 
*./ 

public StoreProviderType getTypeO 

{ 

//Not used by this Provider 
return null; 

} 



/ * * 

* Called by a client to ask for product information on the Provider. 
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* 

* ©return StoreProviderlnf o containing information on this Provider. 
*/ 

public StoreProviderlnf o getlnfo () 

return new StoreProviderlnf o ( MANUF_NAME, 

MANUF__CONT, 
APP_NAME, 
VERSION, 
BUILD, 

APP RELEASED ) ; 



/ * * 

* Tells the context to update its property set. It will throw a 

SPInval idContext PropsExcept ion 

* if it does not accept the properties. 
* 

* ©param props The new set of properties to commit. 
*/ 

public void updateProps (Properties p) { ; } // no provider-wide properties 



* ©return a boolean indicating whether or not the context can offer required properties. 
*/ 

public boolean hasRequiredProps ( ) 
{ 

return true; 

} 



/ * * 

:2? * Retrieves a ContextProperties object containing user-editable required and optional 
U? * properties 

o * 

iS * ©return ContextProperties object containing user-editable required and optional 
properties. 

M */ 

\*k public ContextProperties getPropsO 

^ Properties required = (props == null) ? new PropertiesO : (Properties) props. clone 
() ; 

return new ContextPropert ies ( new PropertiesO, required); 

} 

} 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com. thinairapps . platform . provider . * ; 

//Core Java API 
import java.util.*; 
import j ava . net . * ; 
import j ava . io . * ; 



I * * 

* @ (#) SimpleWebProvider . java 
* 

* This provider contacts an HTTP server, strips out all 

* of the markup, and returns its content to the Connector 
*/ 

public class SimpleWebProvider implements StoreProvider 
{ 

private static int counter = 0; 

O private SimpleWebProviderContext myContext; 
private int instanceNumber ; 
private Support edl terns supportedl terns ; 



* Build a new SimpleWebProvider. . 
*/ 

public SimpleWebProvider ( ) 

{ 

instanceNumber = ++counter; 

System. out .println ("Starting SimpleWebProvider "+instanceNumber+" -.."); 

□ } 



/★* 

* Create a connection to the back-end data store and retrieve Supportedl terns . Each 

instance 

* of a Provider represents a connection with the back-end store. A Connector writer * 

must 

* execute S tore Provider Proxy ' s connectUser method before performing any other action \£ 

with 

* regard to the Provider . 
* 

* The Supportedl terns object that is returned by the connectUser method wraps a Vector of 

* Supportedltem objects, indicating what items and actions a StoreProvider supports for 

a 

* given user. 
* 

* ©return set of supported items based on user's access 
*/ 

public Supportedl terns connectUser (StoreProviderLogin login, StoreProviderContext context) 

// Because this Provider uses a stateless connection for each GET request, 
//there is no backend session to initialize here 

supportedl terns = new Supportedl terns () ; 

String name = SimpleWebProviderContext .APP_NAME ; 

String location = null; 

try { 

location = InetAddress . getLocalHost ( ) .getHostAddress ( ) ; 
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} catch (Exception e) { 

location = "localhost" ; 

} 

// Support no actions 

short actions [] = new short [0] ; 

Supportedltem item = new Supportedltem (SimpleWebProviderContext . WEB_PROVIDER_RESULT, * 

name, location, actions); 
supportedl terns . addltem ( item) ; 

return supportedl terns ,- 



/ * * 

* The disconnectUser ( ) method logs a user off of a Provider. The Provider cannot be 

* used again until another user is logged on via the connectUser method. 
*/ 

public void disconnectUser ( ) 

// Similarly, there is nothing to do at disconnect time 

System. out .print In ("SimpleWebProvider " +instanceNumber+ " shutting down.") ; 

} 



/* * 

* Queries the StoreProvider for the locations it supports for the currently connected 

* user and returns the list. 
* 

* For this simple Provider there is no user data location 
* 

public Us erDat allocations getLocations (UserDataLocationRequest req) 
{ 

return null; 

2 } 



/ * * 

* UserDataActions tell the provider to modify the backend data store in some way. 

* The only allowed modifications or "actions" are those specified when the user 

* logs on via connectUser. 
★ 

* This simple provider does not support any actions 
* 

* ©param action describes the requested action 

*/ . . , 

public UserDataActionResponse doUserDataAction (UserDataActxon action) 

{ 

return null; 

} 



/ * * 

* The getUserData method is the means by a request is made for data from the data store. 

* This method is not used to performs action on data. 
* 

* This Provider uses UserDataRequest s to retrieve information from some back-end HTTP 

server. » 

* It processes the request by extracting the url from the request, contacts the web 

server, 

* retrieves the data, and returns it to the Connector. 
* 

* ©param request represents the UserData request object 
*/ 
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public UserData getUserData (UserDataRequest request) 

ItemRequest itemReq = request . requests [0] ; 

// Prepare the return object 

UserData ud = new UserData () ,- 

ud. responses - new I temReques t Response [ 1 ]; 

ud . responses [0] = new I temRequestResponse ( ) ; 

ud . responses [0] . request = itemReq; 

short type = itemReq . itemType ; 

// Verify that the request is of the correct itemType 

if (type != SimpleWebProviderContext . WEB_PROVIDER_RESULT) 

throw new Runt imeExcept ion ( "Unknown item request type: n +type) ; 

// The requested URL is wrapped in a StringBound 

StringBound bound = (StringBound) ud . responses [0] . request . bounds [0] ; 
String url = (String) bound . getValue () ,- 

// Use the URL request tool to retrieve the page and process the results 
String data = urlTool . getPageAndProcess (url , 0) ; 
WebProviderResult result = new WebProviderResult (data) ; 

._ // Finish loading the return object 

M ud. responses [0] . items = new Storeltems ( ) ; 

*0 ud. responses [0] . items . addElement ( result ) ; 



return ud; 



" ~\ 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com. thinairapps .platform. provider . * ; 
import com. thinairapps . platform . connector . * ; 
import com. thinairapps . platform . device . * ; 

//Core Java API 
import j ava . net . * ; 
import j ava . io . * ; 
import java .util . * ; 



j * * 

* @ {#) SimpleWebConnector . java 
* 

* This Connector provides wireless clients with a simple user interface for requesting 

* a WWW page. The web page is stripped down and returned as raw text- 
*/ 

public class SimpleWebConnector implements Connector 

ip //Declare variables global to this Connector 
■S private Connect or Access connectorAccess,- 

private String connectorName; 
""~4 private String path; 

l\i //The maximum page length to be returned (in bytes) 
^ private static final int MAX_PAGE = 4 00; 



/**init() is called by the ThinAirServer when the Connector is loaded. It provides the * 
Connector 

* with resources it needs to interact with the ThinAirServer. 
* 

* ©param name indicates the friendly name of this Connector application. It is a String 

* derived from connector.ini and this sample does utilize it. 

* ©param path is the URL path to this Connector application. It is a String derived 

* from connector.ini and this sample does utilize it. 

* ©param iniProps is a Properties object containing developer assigned, * 

connector- speci f i c 

* properties. It is derived from connector.ini and this sample does not * 
utilize it. 

* ©param ca is the one-and-only interface a Connector obtains to gain access to the 

runtime services 

* (such as session and user profile management) offered by the ThinAir 
Server to running 

* Connectors . This sample uses it . 

* ©param appLog is used for logging. This sample does not use it. 
*/ 

public void init (String name, String path, Properties iniProps, ConnectorAccess ca, com. 
thinairapps . platform, connector . ApplicationLog appLog) 

{ 

connectorName = name ; 
connectorAccess = ca; 
this. path = path; 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a ^ 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 
the names of all 
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* DeviceProf iles supported by this Connector. These names are the friendly names used 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer kT 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile 1 s getName ( ) method. 

* 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 

* ThinAir Server Developer Guide. 
* 

* ©return an array of Strings representing the friendly names of the devices this 

Connector supports. 

*/ 

public String [] getDevicesO 

^ String [] devices = { "TA_WAP" , " TA_UP WAP " , M TA_NOKIA_WAP" , 

"TA_PALM_VI I " , " TA_GOWEB_PALM " , " T A_OMN I S KY " , 11 TA_HTML " } ; 

return devices; 

} 



f J? 



/**The handle method implements the core logic of a Connector. It takes an incoming *r 
request from a 

* particular device, and returns an appropriate response. This method is called whenever/ 

0 the server 

*f! * receives a request from a type of device that the Connector indicates it supports, \l 
i« destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of 
"""4 the Connector 

,E * to interpret the request and generate an appropriate response. 

» - : * 

* The server will pass a Device object containing as much information as possible into *r 
M this method. 

i'Q * The Connector can then utilize the particular Device class to determine more detailed 
information 

* on the capabilities of the particular device making the request. 

1 === * 

111 * ©param reqProps - represents the HTTP request 

5*2 * ©param device - the actual wireless device instance making the request 

* ©param out - the OutputStream to write back the response 
*/ 

public void handle ( Properties reqProps, Device device, OutputStream out) throws / 
IOException 

{ 

//This will hold the return markup 
String result = null; 

//Check the URL to see what action is being requested by the client 
String action - reqProps .getProperty ( "a" ) ; 

try 

//Is the user returning or is it their first time using the Connector? 
String sessionID = reqProps . getProperty (" sid" ) ; 

if (sessionID == null || (! connectorAccess . sessionValid (sessionID) ) ) 

{ 

//Create a session for this user 

//The session ID will be passed back and forth in the request URL 
sessionID = connectorAccess . createProviderSession (SimpleWebProviderContext . 

APP_NAME) ; 
reqProps .put ( "sid" , sessionID) ; 
initProvider ( sessionID) ,- 

} 

//If this is the first request by the device 
if (action == null || action . equals ("") ) 

{ 

//Return the URL input page 



C: \TASS\ . . \Applications\WebScraper\src\SimpleWebConnector . java 

result = showURLInputUl (reqProps, device); 

} 

else if (action. equals ("get" ) ) 
{ 

//If the user has requested the URL input page 
String pn = reqProps . get Property ( "pn" ) ; 

if ( pn. equals ("-1") ) 

result = showURLInputUl (reqProps, device); 

} 

//Use the backend Provider to retrieve a page and process it 

//Cache the entire page and dole it out in IK chunks 

else 

result = getURL (reqProps , sessionID, device); 

} 

else 

throw hew Exception ( "Unknown action: "+action) ; 

} 

catch (Exception e) 
{ 

//Catch all exceptions and generate an error page 
e .printStackTrace ( ) ; 

O result = renderException (e , device); 

|Q out- write ( result . getBytes ( ) ); 



/ * * 

* Generate a page with a URL input user interface 
*/ 

protected String showURLInputUl ( Properties reqProps, Device device) throws Exception 

^ //Use different utility classes to render output depending on the markup required by * 
the device 
if (device instanceof WAPDevice) 

return WMLRenderer . showURLInputUl (connect orName , path, reqProps); 
else if (device instanceof HTTPDevice | | device instanceof PalmVIIDevice | | device * 
instanceof GoWebPalmDevice | | 

device instanceof OmniSkyDevice | | device instanceof HTMLDevice ) 
return HTMLRenderer . showURLInputUl (connect orName , path, reqProps); 

//This simple web Connector does not support all devices 
else 

throw new Exception ( "Device " +device . getProf ile ( ) .getName ( ) + " not supported"); 



/*■* 

* Retrieve a page either from cache or from the backend Provider and return it in IK 
chunks 

*/ 

public String getURL (Properties reqProps, String sessionID, Device device) throws 
Exception 

Hashtable sessionCache = connectorAccess . getSessionCache ( sessionID ); 
// the requested URL 

String url = reqProps . getProperty ( "url ") ; 
String page; 

String retString = null; 
int endlndex, length; 
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//Is the user asking for MORE of a page that has already been retrieved, 
//or is this a request for a fresh page? 
String pn = reqProps . getProperty ( "pn" ) ; 
if (pn == null) 

{ 

pn = "0" ; 

reqProps . put ( "pn" , " 0 " ) ; 

} 

// If this is a first-time request 

if (pn. equals ( n 0 M ) ) 

{ 

// retrieve the data 

page = requestPage (sessionID, url) ; 

// store entire page in session cache 
sessionCache .put ( "page" , page) ; 

// return first IK of text 
length = page . length ( ) ; 
if (length < MAX_PAGE) 
{ 

endlndex = length; 
retString = page; 

} 

else 

{ 

endlndex = MAX_PAGE; 

retString = page . substring (0 , endlndex) + 

} 

} 

else 

{ 



"4 //Retrieve the page from the session cache 

IS //Look at the pageNumber (pn) 

//Retrieve substring with chars (pn * MAX_PAGE) > (pn + 1) * MAX_PAGE 

!s=. //from the page 

M int num = Integer . parselnt (pn) ; 

m page = (String) sessionCache . get ( "page " ) ; 

i==s length = page . length () ; 

endlndex = (num +1) * MAX_PAGE ; 

if (endlndex >= length) 
O retString = " . . . " + page . substring (num * MAX_PAGE) ; 

|_l else 

s *~ retString = "..." + page . substring ( num * MAX_PAGE , endlndex ); 

} 

//Use different utility classes to render output depending on the markup required by 

the device 
if (device instanceof WAPDevice) 

return WMLRende re r . showURLOut put (connect orName , path, reqProps, retString \£ 
, (endlndex < length) ) ; 

else if (device instanceof HTTPDevice | | device instanceof PalmVIIDevice | | device * 
instanceof GoWebPalmDevice | | 

device instanceof OmniSkyDevice | | device instanceof HTMLDevice ) 
return HTMLRende re r . showURLOutput (device , connectorName, path, reqProps, * 
retString, (endlndex < length) ) ; 

// this simple web Connector does not support all devices - return error 
else 

throw new Exception ( "Device " +device . getProf ile ( ) . getName ( ) + " not supported"); 



/* 

* Generate an exception page 
*/ 
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private String renderExcept ion (Exception e, Device device) 

//Use different utility classes to render output depending on the markup required by 

the device 
if (device instanceof WAPDevice) 

return WMLRenderer . renderExcept ion (e) ; 
else if (device instanceof HTMLDevice) 

return HTMLRenderer . renderExcept ion (e) ; 

else 

return "ERROR: "+ e . getMessage ( ) ,- 



/* 

* Initialize the Provider that we will contact again when the user enters a URL 
*/ 

private void initProvider (String sessionID) throws Exception 

{ 

//Retrieve the StoreProviderProxy for an existing session 

StoreProviderProxy spProxy = connectorAccess . getStoreProvider (sessionID) ; 
//Construct this object for pedagogical purposes only 

StoreProviderLogin login = new StoreProviderLogin (null , null, null) ; 
Supported I terns supports = spProxy . connectUser ( login) ; 

O if (supports == null) 

^ throw new Exception ( "Error in connectUser. Provider is unavailable" ) ,- 

^ } 



f *Request a page from the Provider and return it 

n */ 

private String requestPage (String sessionID, String url) throws Exception 

~ //Retrieve the StoreProviderProxy for an existing session 

II StoreProviderProxy spProxy = connectorAccess . getStoreProvider ( sessionID) ; 

^ //Construct the request object 

fj UserDataRequest request = new UserDataRequest ( ) ; 

xJ request . requests = new ItemRequest [1] ; 

si request . requests [0] = new ItemRequest () ; 

request . requests [0] . itemType = SimpleWebProviderContext . WEB_PROVIDER_RESULT; 

request . requests [0] .bounds = new Bound [1] ; 

request . requests [0] .bounds [0] = new SimpleURLBound (url ) ; 

//Contact the Provider and make the UserDataRequest 
UserData response = spProxy .getUserData (request ) ; 

//Extract the data 

Storeltems items = response . responses [0] . items ; 

WebProviderResult result = (WebProviderResult ) items . elementAt ( 0 ) ; 
return result . getText () ; 

} 

} 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 



//Core ThinAir Server API functionality 
import com . thinairapps . platform . provider . * ; 



/ ** 

* @(#) SimpleURLBound. java 
* 

* Connectors and Providers can use this bound to request a specific URL 
* 

public class SimpleURLBound extends StringBound 
{ 

/ * * 

* Create a new SimpleURLBound to request a specific URL 
* 

* ©param String the url to request 
*/ 

public SimpleURLBound (String url) 
■S super (url, StringBound . COND_EQUALS ) ; 

it 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com. thinairapps .platform. * ; 
import com. thinairapps .platform. device .* ; 

//Rendering packages used to build markup 
import com . thinairapps . tag . * ; 
import com. thinairapps . tag . html . * ,- 

//Core Java API * 
import java.util.*; 



* @ (#)HTMLRenderer . java 
* 

* A utility class containing static methods for rendering output in html 
*/ 

.public class HTMLRenderer 

■M /+* 

"~ * Generate a WML page with a GUI with which the user can enter a URL 



m 



* ©param connect orName the name of the connector 

* ©param path the HTTP path that maps to this Connector 

* ©param reqProps the parameters of the original request + the session identifier 
*/ 

public static String showURLInputUI (String connec t orName , Strxng path, Properties 
reqProps) throws Exception 

//Create the basic "page" object, used for all HTML document rendering 
HTMLTagDocument doc = new HTMLTagDocument ( ) ; 
Head head = new Head ( ) ; 

Meta meta = new Meta ( "name" , "PalmComputingPlatf orm" , "true") ; 
head.addChild (meta) ; 

head.addChild(new Title ( "Enter URL")); 

doc . setHead (head) ; 

//create the body 

Body body = new Body ( ) ,- 

Font font = new Font ( "geneva , arial " , 3) ; 
Break br = new Break ( ) ; 

//All children tags of this tag will be centered on the page 
Center center = new Center ( ) ; 

center .addChild( new Text ( " <B> "+ connect orName* " </B> " ) ); 
center .addChild( br ) ; 

center .addChild ( new HorizontalRule ( ) ); 
center .addChild ( br ); 

font . addChild (center) ,- 

//Create the form 

Form form = new Form ( "getURL" , path, "GET"); 
//Add form input elements 

form. addChild ( new Input ( "hidden" , "a", "get") ),- 
form. addChild ( new Input ( "hidden" , "pn" , "0") ); 

form. addChild ( new Input (" hidden" , "sid", reqProps . getProperty (" sid" ) ) ) ; 
form. addChild ( new Text("Enter URL: ") ); 
TextField text = new TextField ( "url " , " " , 17); 
text.addAttribute( new Attribute ( "maxlength" , "50") ); 
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form. addFormElement (text ) ; 

form. addFormElement (new SubmitButton ( "Go" ) ) ; 

font .addChild (form) ; 

body. addChild (font) ; 
doc . set Body (body) ; 

//Returns the entire rendered document text, suitable for display in an HTML browser 
return doc . render { ) ; 

} 



* Generate a page displaying a portion of the requested web page 
* 

* ©param connect orName displayed at the top of the page 

* ©param path used to issue another request 

* ©param reqProps the properties of the original HTTP request 

* ©param page the actual page text 

* ©param more is there any more data available 
*/ 

public static String showURLOutput (Device device , String connec t orName , String path, y? 
Properties reqProps, 

String page, boolean more) 

{ 

//Retrieve the SessionID from the URL and create a reference to it 
String sessionID = reqProps .getProperty ( "sid" ) ; 

//Create the basic "page" object, used for all HTML document rendering 
HTMLTagDocument doc = new HTMLTagDocument ( ) ; 
Head head = new Head ( ) ; 

Meta meta = new Meta ( "name" , " PalmComputingPlatf orm" , "true"); 
head.addChild (meta) ; 

head. addChild (new Title (connectorName) ) ; 
doc . setHead (head) ; 

//create the body 

Body body = new Body ( ) ; 

//A tag indicated text styling parameters 
Font font = new Font ( "geneva , arial " , 3) ; 
Break br = new Break ( ) ; 

//Get the URL that the user entered 
String url = reqProps .getProperty ( "url ") ; 

font .addChild ( new Text (url) ); 

font .addChild ( br ) ; 

font .addChild ( new HorizontalRule ( ) ); 

font .addChildt br ); 

font .addChild ( new Text (page) ); 

font .addChildt br ) ; 

StringBuffer sb; 

//Turn simple links into anchor buttons 

Attribute button = new Attribute ( "BUTTON" , "BUTTON") { 
public String render () { return "BUTTON"; } 

}; 

//Get the page number that the user is on 

int pn = Integer . parselnt ( reqProps .getProperty ( "pn" ) ); 

//Get the request action 

String action = reqProps . getProperty ( "a" ) ; 



//If there's more of the page then construct the more link and increment the page * 
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number variable 
if (more) 

{ 

// Build the request url 

sb = new StringBuf f er ( 56 ) ; 

sb. append (path) ,- 

sb . append ( 11 ?a=get&amp ; url= " ) ; 

sb. append ( url ) ; 

sb . append ( " &amp ; pn= " ) ; 

// Increment the page number 

sb. append ( String . valueOf ( ++pn ) ); 

sb . append ( " &amp ; s id= " ) ; 

sb. append ( sessionID ) ,- 

sb . append ( " &amp ; rnd= " ) ; 

// Append a random number to combat caching 
sb . append (Math . random ( ) ) ; 

String href = sb . toString ( ) . trim ( ) ; 

Anchor anchor = new Anchor ( "More", href, new Text ("More") ) ; 
anchor .addAt tribute (button) ; 



} 



font .addChi Id (anchor) ; 

font . addChild (new Text ( " &nbsp ; &nbsp ; fcnbsp ; " ) ) ; 



// Now for the back link. . . 

// Depending on the device version, make the back link point to the appropriate vr 

request page 
if (device instanceof HTMLDevice) 

{ 

//Build the request url 

sb = new StringBuf fer ( 56 ) ; 

sb. append (path) ; 

sb. append ( " ?a=get&url= 11 ) ; 

sb. append ( url ) ; 

sb . append ( " &amp ; pn= " ) ; 

// If there's more of the page, decrement the page number by 2 since we just * 
incremented 

// it for the purposes of creating the 'more 1 link 
if (more) 

{ 

sb. append ( String . valueOf ( pn - 2 ) ); 

} 

else 

sb. append { String .valueOf ( --pn ) ); 

} 

sb . append ( " &amp ; s id= " ) 
sb. append ( sessionID ) 
sb . append ( " &amp ; rnd= " ) 

//Append a random number to combat caching 
sb . append (Math . random ( ) ) ; 

String href = sb . toString (). trim () ; 

Anchor back = new Anchor ( "Back", href, new Text ( "Back" ) ) 
back . addAttribute (button) ; 
font . addChild (back) ; 

body .addChild (font) ; 



doc . set Body (body) ; 
return doc . render ( ) ; 
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} 



/ * * 

* If its a palm device. . . 

* To create a PQA application for the Palm VII that integrates with the ThinAir Server^ 
/ you 

* will need to understand and use "Web Clipping" technology from Palm. Web Clipping 
involves 

* essentially creating HTML interfaces into your applications. To find out more about 

* creating PQAs and Web Clipping technology, visit: http://www.palmos.com/dev/tech/ \l 
webclipping/ 

*/ 
else 

Anchor back = new Anchor ( "Back", " f ile : webScraper . pqa " , new Text ("Back") ); 
back. addAttribute (button) ,- 
font .addChild (back) ; 

body .addChild( font) ; 

doc . set Body (body) ; 
return doc . render ( ) ,- 



* Generate a page describing an error that has occured 
* 

* ©param e - An exception which you wish to render 
*/ 

public static final String renderExcept ion (Exception e) 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 
Head head = new Head ( ) ; 

Meta meta = new Meta ( "name" , "PalmComputingPlatf orm" , "true"); 
head. addChild (met a) ; 

head. addChild (new Title ("Enter URL") ) ; 
doc . setHead (head) ; 

Body body = new Body ( ) ; 
Break br = new Break ( ) ; 

Font font = new Font ( "geneva, arial " , 3); 
font .addChild ( br ) ; 

font .addChild (new Text ("ERROR: "+e . getMessage ( ) ) ) ,- 
body. addChild ( font ) ,- 

doc . setBody ( body ) ; 

return doc . render ( ) ; 



} 
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ThinAir Distributed File Store provider 
Microsoft windows NT/2000 Distribution, version 1.1 
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What's in this Distribution 



The Distributed File Store Provider allows individual users with a "ThinAir Powered Enterprise" to 
wireless enable access to a set of disk based documents. The Provider maps your file system directories 
and file names to Groupware "Messages" and "Folders". The type of files supported by this release 
include: 

-MS Word 2000 Documents (.doc) 
-html Pages (.html,. htm) 
-Plain Text (.txt) 
-XML Documents (.xml) 
-Java source code (.java) 

This software also demonstrates the highly distributable capabilities of the ThinAir server Platform. 



security 



^11 authentication is done against existing NT Domain accounts, when you setup your TA Groupware Account, 
"j^ou must supply the following information: 

W provider: your personal provider name (specified in provider.ini) 

Sj Host: your NT Domain (i.e. "taaps_lan") 

«^ UserName: your NT Account Login 

= p password: your NT Account Password 

;^ilso, access to the file system is controlled by the same permissions granted to the user account which 
h 4s running the provider. 



s installing the Application 



IjHere's a step by step: 

^3.) Copy the file "TAAuthutils.dll" into your windows or winNT directory. 

T~i) Open the file "provider.ini" edit the properties: 

\\_ -providerName=f. beano 

The ProviderName property must be a unique name. The scheme used above should be 
employed to help guarantee uniqueness within an NT domain. Replace "beano" with 
your NT login. 

-oef aul tBasePath=\\tapdc\data\ 

The DefaultsasePath is the "root" location which the File store Provider should browse 
from. 

-userDi rectory : beano=\\tapdc\us r\beano\ 

To specify a user specific directory, you can add "userDi rectory :<nt i_ogin>" parameters 
for every user, again, we recommend simply replacing "beano" with your NT Login. 

3) Launch the "startProvider.bat" file. This should register your provider with the TAS server running on 
10.1.1.47 (our primary thinair server). 

4) Now you need to setup an account with the tas server in the same way you would for access to any 
standard Groupware Provider. 

-Select your provider name from the drop-down list 

-For the host, enter our NT Domain "taaps_lan" 

-Enter your NT Login and password (or leave the password blank) 

-you can leave display, email blank 

-Name the account 
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-Save it! 



5) Now login' If your BaseDi rectoryPath or UserDi rectory points to a directory with only folders inside 
of it you first inbox" view will be blank, if you browse folders, you should be able to see all of th 
subdirectories, select one with files, and your 'inbox" should get populated by them. 



Known issues 



-Some MSWord documents cannot be opened 

-This has not been tested on windows 98, though it may work 



Support and Bug Reporting 

well, this is basically unsupported, but I would like to hear about certain bugs 
you may find, specifically regarding problems reading certain types of documents. 



Last updated: 8.18.2000 
Copyright 1999, 2000 ThinAirApps, inc. 
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package thinairapps .groupware . storeproviders . file ; 

import j ava . io . * ; 

public class DocumentConverter 
{ 

public final static String TYPE_TEXT = "text/plain"; 

public final static String TYPE_HTML = "text/html"; 

public final static String TYPE_WORD = "application/msword" ; 

public static String readDocument (File file, String mimeType) 
{ 

try 

{ 

if (mimeType == null) 

return null ; 
else if (mimeType. equals (TYPE_TEXT) ) 

return getASCII (file) ; 
else if (mimeType. equals (TYPE_HTML) ) 

return getHTML (file) ; 
else if (mimeType. equals (TYPE_WORD) ) 

return getMSWord (file) ; 

_ else 

O return null; 

IS } 

catch (Exception e) 

2 { 

a fcs return null; 

ill } 
q ) 

IE public static String getASCII (File file) 
{ 

j=s String data = readFile (file) ; 

'jf return data; 

jfi } 

iS- public static String getHTML (File file) 

m { 

String data = readFile (file) ; 
return HTMLRipper . processPage (data) ; 

> 

public static String getMSWord (File file) 
{ 

String data = readFile (file) ; 

int startldx = data . indexOf ( "U" ) ; 

if (startldx != -1) 

return data . substring ( startldx+l) . trim ( ) ; 

else 

return data; 

} 

private static String readFile (File file) 

{ 

try 
{ 

FileReader f is = new FileReader (file) ; 

Buf f eredReader reader = new Buf f eredReader (fis) ; 

StringBuffer out = new StringBuf f er ( ) ; 

String line = reader . readLine () ; 

while (line != null) 
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{ 

if (line.lengthO > 0) 

out. append (line + "\n M ); 

line = reader . readLine () ; 

} 

return out . toString ( ) ; 

} 

catch (lOException e) 
{ 

return "Unable to read file: " + e; 

} 



} 
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package thinairapps .groupware . storeproviders . file ; 

import javax.mail . * ; 
import javax.mail . internet . * ; 
import javax.mail . event -* ; 
import java.util.*; 

import javax. activation. * ; 



public class Document Sender 
{ 

public static void sendDocument (String file, String server, String from, String to, 
String subject, String msgTextl) 

// create some properties and get the default Session 
Properties props = System. getProperties ( ) ; 
props .put ( "mail . smtp. host" , server) ; 

Session session = Session .getDef aultlnstance (props , null) ; 
session. setDebug (false) ; 

try { 

// create a message 
O MimeMessage msg = new MimeMessage ( session) ; 

=Q msg . set From (new I nternet Address ( from) ) ; 

Int e met Address [] address = {new I nternet Address ( to) } 
\- s msg. setRecipients (Message. RecipientType .TO, address); 

'H msg. setSubject (subject) ; 

-i^-! 

U% /I create and fill the first message part 

MimeBodyPart mbpl = new MimeBodyPart ( ) ; 
3 mbpl . setText (msgTextl ) ; 

// create the Multipart and its parts to it 
J=- Multipart mp = new MimeMultipart ( ) ,* 

^ mp .addBody Part (mbpl) ; 

|2 // create the second message part 

MimeBodyPart mbp2 = new MimeBodyPart () ; 

O // attach the file to the message 

l r L FileDataSource fds = new FileDataSource ( f ile) ,* 

mbp2 . setDataHandler (new DataHandler (f ds) ) ; 

mbp2 . setFileName ( fds . getName ( ) ) ; 

mp . addBody Part (mbp2 ) ; 

// add the Multipart to the message 
msg . setContent (mp) ; 



// set the Date: header 

msg . setSentDate (new Date ( ) ) ; 

// send the message 
Transport . send (msg ) ; 

} catch (MessagingException mex) { 

com. thinair .utils .DbgLog. logError (mex) ,- 
Exception ex = null; 

if ((ex = mex. getNextExcept ion ( ) ) != null) { 
com. thinair .utils .DbgLog . logError (ex) ; 

} 

} 

} 

} 
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package thinairapps .groupware . storeproviders . file ,- 

import com . thinairapps . platform . provider . * ; 
import com. thinairapps .platform. exception. * ; 



import thinairapps . groupware . api . * ; 

import thinairapps . groupware . api . actions . * ; 

import com. thinair .utils . * ; 

import java .util .Vector ; 

import java .util . Enumeration; 

import java. util .Properties; 

import java . util .Date ; 

import java. util . StringTokenizer ; 



import j ava .10,*; 

import com. ms . com. Variant ; 
import com.ms .wf c . app.Time; 
import com. thinair .utils .Win3 2 .COMTypes; 
import com. thinair .utils .DbgLog ; 
.import com.ms .Win32 .Advapi 32 ; 

"Emport com.ms . security . permissions . * ; 
ligmport com.ms . security .* ; 
^import com.ms .util -* ; 

2* * 

4«* An File StoreProvider that offers the following types of objects from the 
M* GroupwareObjectSet : 

h '. "*=* 

.'ir* "message" - Message objects from a user's folder. The item locations correspond to * 

W IMAP 

= * folders, the default being INBOX. 

]'^* ©author meyerwil 

!!:*/ 

public final class FileStoreProvider implements StoreProvider 



II Version info 

protected static final String VERSION 
protected static final int BUILD 
protected static final String APP_NAME 
protected static final String MANUF_NAME 
protected static final String MANUF_CONT 
protected static final Date APP_RELEASED 



.0 Early Access 2 ,f ; 



"1 
l; 

"ThinAir File Provider" 
"ThinAirApps" ; 
"www.ThinAirApps . com" ; 
new Date (100, 0, 5) ; 



private final static int DOC_LENGTH_MAX = 25000; 

public static final int FOLDER_SEPERATOR = 0x2 F ; 

static final Variant V_FAL.SE = new Variant (false) ; 
static final Variant V_TRUE = new Variant (true) ; 
static final Variant V_NOPARAM; 

private static final int VB_DOUBLE = 5; 
private static final int VB_STRING = 8; 



public static final Variant 
private static final Variant 
private static final Variant 
private static final Variant 
private static final Variant 



V_PROPTAG__CONTAINERTYPE = new Variant (0x3613001EL) ; 

V~PROPTAG_PUBLICSTORE__ROOT = new Variant (0x6 63 10 102L) 

V_PRO FILENAME = new Variant ( " " ) ; 

V_PW = new Variant ( " " ) ; 

V PARENTHWND = new Variant ((int)-l); 



private int m_currLocat ionDepth ; 
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private static final String DEFAULT_LOC = "Files"; 

private static String SMTP_HOST = "localhost"; 

private static String MIME_TYPE_FILE_PATH = ". /mime . types" ; 

private StoreProviderLogin login ; 

private final static String NO_BODY_MSG = "Document type not supported for viewing."; 
static 

V_NOPARAM = new Variant ( ) ; 

V_NOPARAM . no Pa ram ( ) ; 

} 

private static Properties mimeTypeMap ; 
/ * * 

* Constructs an IMAPStoreProvider instance with an always-used FetchProf ile . 
* 

* ©author meyerwil 
*/ 

public FileStoreProvider () 
if (mimeTypeMap == null) 

{ 

try 

^ loadMimeTypeFile (MIME_TYPE_FILE_PATH) ; 
} 

catch (Exception e) 
{ 

e -printStackTrace 0 ; 

} 

} 

} 

private String getBasePath (String login) 

^ DbgLog . logStatus ("FileProv: looking up user basepath"); 
return FileStoreProviderContext .getUserDirectory (login) ; 

} 

/ * * 

* Instances can share the javamail session, an LDAP handler, and the SMTP server through* 

the . ^ 

* context object. This method attempts to reuse shared resources or creates new ones i£ 

* needed. Upon completion, the session, smtp and ldap members will be adjusted with any* 



shared 
* resources. 



* 

* ©param popContext The POPStoreProviderContext instance shared across POPStoreProviders 
+ 

* ©author meyerwil 
*/ 

private void setupSharedStuf f (FileStoreProviderContext fileContext) 

^ SMTP_HOST = fileContext . m_props .get Property ( " SMTPHost " ) ; 

MIME_TYPE_FILE_PATH = f ileContext . m_props . get Property ( "MimeTypeFilePath" ) ; 

} 

private void authenticateUser (StoreProviderLogin login) throws 
AuthenticationFailedException 

//need to implement directory lookup here 
this. login = login; 
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if (AuthenticateUserByUsernamePassword (login . name, login .password, login. host) != 0) 
throw new AuthenticationFailedException { ) ; 



} 

/** ©dll. import ("taauthutils.dll ") */ 

private static native int AuthenticateUserByUsernamePassword (String userName, String 
password, String domain) ; 



/ * * 

* Logs a user on to an IMAP store using the information in login. A Caller must log on 

by 

* calling this function before doing anything else with the object. 
* 

* ©param login An object containing the required login information. 

* ©param context A StoreProviderContext used for all StoreProvider instances. 
* 

* ©return A Supportedl terns object containing information on the supported actions and * 

item types 

* for this user. 
* 

^ * ©author meyerwil 
!f */ 

p public Supportedl terns connectUser (StoreProviderLogin login, StoreProviderContext 
■f% context) throws ProviderException 

2 short actions [3; 

t Supportedl terns supportedl terns ; 

y Supportedl tern supportedl tern, - 

"= FileStoreProviderContext fileContext; 

J3 // Make sure the password is correct 

DbgLog . logStatus ( " FileGroupwareProvider . connectUser : Authenticating user"); 
authent icateUser (login) ; 

P- DbgLog. logStatus ( " FileStoreProvider . connectUser : Connecting..."); 

3 if ((context == null) || ! (context instanceof FileStoreProviderContext)) 
f% throw new I nvalidCon text Except ion (); 

JJ fileContext = (FileStoreProviderContext ) context ; 

=1 synchronized (this) 

* { 

try 

{ 

// Do item support stuff 

supportedl terns = new Supportedl terns (); 

actions = new short [2] ; 

actions [0] = Actions . ADD_NEW_GROUP WARE_ITEM ; 
actions [1] = Actions . DELETE_GROUPW ARE_ ITEM; 

supportedltem « new Supportedltem ( I temTypes . MESSAGE , "Files", DEFAULT_LOC, * 
actions) ; 

supportedl terns . addl tern (supportedltem) ; 
return supportedltems ; 

} 

catch (Exception e4) 

throw new ProviderException (e4 + " + e4 . toString ( ) ) ; 

} 

} 

} 

I * * 

* Returns all of the folders provided by the IMAP host. Location names will include 

* forward slashes ('/') to indicate the hierarchy. This provider supports only Message 

items 
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* and the caller must therefore not request locations for other types of items. 

* ©param req The request forlocations meeting certain criteria. 
* 

* ©return A UserDataLocations object containing the retrieved locations that match the 

* requested criteria. 
* 

* ©author meyerwil 
*/ 

public UserDataLocations getLocations (UserDataLocationRequest req) throws w 
ProviderExcept ion 

{ 

File dir = null; 
String rootPath = null; 

if (req. root Location != null && ! (req . root Location . equals (DEFAULT_LOC) ) ) 

^ String path = getBasePath (login. name) + req. rootLocat ion . replace ( (char) n 
FOLDERJSEPERATOR, ' \\ ' ) ; 
dir = new File (path) ; 
rootPath = req . rootLocat ion; 

} 

else 

dir = new File (getBasePath ( login . name) ) ; 

} 

StringH dirList = dir. list (); 
String [] folderNames = new String [0] ; 

if (dirList != null) 

Vector folders = new Vector (),- 

File file; 

for (int i = 0; i < dirList . length; i++) 

^ file = new File ^(dir . getAbsolutePath ( ) + File . separator -i- dirList [i] ) ; 
if (f ile. isDirectory () ) 

{ 

if (rootPath 1 = null) 

folders .addElement (rootPath + ( (char) FOLDER_SEPERATOR) + dirList [i] ) ; 

else 

folders .addElement (dirList [i] ) ; 

} 

} 

folderNames = new String [f olders . size () 3 ; 

for (int i = 0; i < f olders . size () ; i++) 

folderNames [ij = (String) folders . elementAt (i) ; 

} 

return new UserDataLocations ( req . itemType , folderNames); 



I * * 

* Closes a connection to the provider -- logs a user off. This method MUST be called if* 

a 

* user successfully logged-on using connectUser () . 
* 

* ©author meyerwil 
*/ 
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public void disconnectUser () throws ProviderException 

{ 
} 



/ * * 

* Retreives files that match the incoming request. This is the entry-point for 

* requesting any Message object The allowable bounds/fields are as follows: 



* 

* Message: 

* (StringltemBound) 

* "subject" 

* "body" 

* "from" 

* (DateltemBound) 

* "received" 



* ©param req The request for specific data from the user's store. 

* ©return A UserData object containing the requested data. 
* 

* ©author meyerwil 
*/ 

public UserData getUserData (UserDataRequest req) throws ProviderException 

UserData data = new UserData () ; 

data . responses = new I temRe quest Response [1] ; 

data . responses [0] = new I temRe quest Response ( ) ; 
data. responses [0] .request = req . requests [0] ; 

data . responses [0] . items = new Storeltems () ; 

( (Storeltems) data. responses [0] .items) . setlsLastAvailable (true) ; 
String path = getBasePath ( login . name) ; 

if (req. requests [0] .itemLocat ion != null && ! (req. requests [0] . itemLocat ion. equals 
(DEFAULT_LOC) ) ) 

path += req. requests [0] . itemLocat ion . replace ('/ 1 , File . separatorChar) ; 

Dbg Log . logs tatus ("FileProv: accessing path: " + path); 

File dir = new File (path) ; 

String [] dirList = dir. list (); 

if (dirList != null) 

DbgLog.logStatus ("FileProv: got directory listing; size=" + dirList . length) ; 

else 

throw new AuthenticationFailedException ( ) ; 



File file; 
Message msg; 
String mimeType; 
String fileExt; 

int startldx = 0; 

if (req. requests [0] . startID != null) 

startldx = new Integer (req. requests [0] . startID . substring (0 , req. requests [0] . 
startID. indexOf (":"))). intValue () + 1; 

for (int i = startldx; i < dirList . length ; i++) 

file = new File (path + "\\" + dirList [i] ) ; 

if ( 1 f ile . isDirectory ( ) ) 
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{ 

DbgLog . logStatus ("FileProv: examining file: " + file .getName ()) ; 
msg = new Message () ; 

( (Storeltem)msg) .setID (i + * + f ile . getAbsolutePath ( ) ) ; 

msg . setReceivedDate (new Date ( file . lastModified ())) ; 
msg . setRead ( false) ; 

msg . addRecipient (Message . RecipientType . TO, new GroupwareUserSMTPAddress (logins 
. name, login .name) ) ; 

mimeType = null; 
fileExt = "NONE" ; 

if (f ile. getName () . indexOf ( " . " ) !="-l) 
{ 

fileExt = file .getName (). substring (file . getName (). last IndexOf ( !, .")+l); 
mimeType = mimeTypeMap . get Property (f ileExt . toLowerCase ( ) ) ; 

} 

msg . setFrom (new GroupwareUserSMTPAddress (fileExt . toUpperCase ( ) , fileExt . * 
toUpperCase ( ) ) ) ; 

|3 String body = null; 

£k try 

-~4 body = DocumentConverter . readDocument (file, mimeType) ; 

i\ ■ catch (Exception e) 

n { 

H DbgLog . logError ("error reading file: " + e) ; 

=3 DbgLog . logError (e) ; 

} 

M if (body !- null) 

tn { 

='3 if (body, length () > DOC_LENGTH_MAX ) 

:~ body = body, substring (0, DOC_LENGTH_MAX) ,- 

13 msg.setSubject ("*" + file .getName {)) ; 

!_l msg . setBody (body) ; 

} 

else 

{ 

msg . setSubject (file .getName ( ) ) ; 
msg . setBody (N0_B0DY_MSG) ; 

} 

data . responses [0] . items . addElement (msg) ; 

} 

if (data . responses [0] . items . size ( ) == req. requests [0] .max) 
{ 

if (i < dirList . length- 1 ) 

( (Storeltems) data . responses [0] .items) . set IsLastAvailable (false) ; 

else 

( (Storeltems) data . responses [0] .items) . set IsLastAvailable (true) ; 
break ; 

} 

} 

DbgLog . logStatus ("FileProv: returning message set"); 
return data; 
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} 

J * * 

* Performs some action on the user's data. This provider only supports 

"add" , "delete" , and 

* "markseen" actions, passed as UserDataAdd, UserDataDelete , and UserDataMarkSeen * 

objects . 

* Adding an item means sending an email message. 
* 

* ©param action The action to be performed on the user data. 
* 

* ©return A UserDataActionResponse containg the results of the action. 
* 

* ©author meyerwil 
*/ 

public UserDataActionResponse doUserDataAction (UserDataAction action) throws * 
ProviderExcept ion 

{ 

thinairapps .groupware . api .Message gwMsg = null; 
synchronized (this) 

if (action instanceof AddNewGroupwareltem) 

{ 

Gr oupwa r eUs e r Addr e s s recipsH; 
i~ E GroupwareUserAddress tempAddr; 

]Jf // we're going to "add" the message, meaning send it 

\U gwMsg = (thinairapps . groupware . api .Message) ( (AddNewGroupwareltem) act ion) . ^ 

•*j getltem ( ) ; 

"£ try { 

*'tJ if (gwMsg instanceof ForwardedMessage) 

i y { 

String filePath = ( (ForwardedMessage) gwMsg) . getOriginallD (); 
(3 int sldx = filePath. indexOf ( " : " ) + 1; 

m filePath = filePath . substring (sldx) ; 

File file = new File (filePath) ; 
M String from = gwMsg . getFrom () .getAddress () ; 

n StringBuffer to = new StringBuffer (); 

■j'T GroupwareUserAddress [] toz = gwMsg .getRecipients (Message. 

~~ Recipient Type .TO) ; 

for (int n = 0; n < toz. length; n+ + ) 

{ 

to. append (toz[n] .getAddress ()) ; 

if (n+1 < toz. length) 
to . append ( " ; " ) ; 

} 

String subject - gwMsg . getSubj ect (); 
String message = gwMsg . getBody (); 

DbgLog . logStatus ("Sending file to ' + to . toString ( ) + "':■'+ 

f ile .getName ( ) '+ " via " + SMTP_H0ST) ; 
DocumentSender . sendDocument ( f ile . getAbsolutePath (), SMTP_HOST, 

from, to . toString () , subject, message); 

} 

else 

throw new InvalidAct ionException (); 

} 

catch (Exception e) 

{ 

if (e instanceof ProviderExcept ion) 
throw ( ProviderExcept ion) e; 




C: \TASS\ . . \groupware\storeproviders\f ile\FileStoreProvider . java 8 

DbgLog . logError ("Caught unknown exception adding item: " + e.toString * 
() ) ; 

throw new ProviderException ("Unable to create item."); 

} 

} 

else 

throw new InvalidAct ionException (); 

} 

return null; 

} 



* 

* ©param mimeTypeFilePath the file path to the Internet Mime Types file 

* which contains mappings from mime types to file extensions 
*/ 

private static void loadMimeTypeFile (String mimeTypeFilePath) throws ^ 
FileNotFoundException, IOException 

{ 

mimeTypeMap = new Properties (),-■ 

File file = new File (mimeTypeFilePath) ; 

if ( !f ile. exists () ) 

throw new FileNotFoundException () ; 

FileReader fis = new FileReader (file) ; 

Buf f eredReader reader = new Buf f eredReader (fis) ; 

String line = reader . readLine () ; 

String mimeType = null, extension = null; 

while (line != null) 

{ 

line = line.trimO; 

if ( Iline.startsWith( "#" ) && line . length ( ) > 0) 
{ 

StringTokenizer st = new StringTokenizer (line) ; 
mimeType = st . next Token ( ) ; 
while ( st . hasMoreTokens ( ) ) 

{ 

extension = st . nextToken ( ) ; 
mimeTypeMap - put (extension, mimeType) ; 

} 

} 

line = reader . readLine () ; 

} 

fis - close ( ) ; 

} 



} 
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package thinairapps .groupware . storeproviders .file; 

import com . thinairapps . platform . provider . * ; 

import java.util .Properties; 
import java.util .Enumeration ; 

/* * 

* Defines a context object for the IMAP provider. 
* 

* ©author meyerwil 
*/ 

public final class FileStoreProviderContext extends StoreProviderContext 
{ 

// Data members 

protected static Properties m_props = null; 

private static Properties basePathStore ; 

private static final String USER_PROP_KEY = "UserDirectory: " ; 
/ * * 

* Retrieves the object set supported by this provider the Groupware object set. 
* 

* ©return A GroupwareObj ectSet instance. 

§3 * 

' g~ * ©author meyerwil 

Iz */ 

^ public StoreProviderType getType () 

ff return new StoreProviderType ( "thinairapps .groupware . api ") ; 

55 } 

'"■sA J * * 

Til * Retireves a ContextProperties object containing user-editable required and optional 

* properties. 



* ©return ContextProperties object containing user-editable required and optional 

properties . 

* 

* ©author meyerwil 
*/ 

public ContextProperties getProps () 

{ 

Properties optional ; 
Properties required; 

optional - new Properties (); 
required = new Properties (); 

return new ContextProperties (optional, required) ; 

} 

/** 

* Tells the context to update its property set. It will throw a ^ 

SPInvalidContextPropsException 

* if it does not accept the properties. This provider does require an SMTP server so ittf 

will 

* throw the exception if the user didn't specify one. 
* 

* ©param props The new set of properties to commit. 
★ 

* ©author meyerwil 
*/ 

public void updateProps (Properties props) 

{ 

m_props = props; 
Enumeration keys = m_props . keys { ) ; 
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2 



String user, dir; 

basePathStore = new Properties (),- 

while (keys .hasMoreElements () ) 

user = (String) keys . nextElement 0 ; 

if (user . startsWith (USER_PROP_KEY) ) 
{ 

dir = m_props . get Property (user); 

user = user. substring (USER_PROP_KEY . length {)) ; 

basePathStore .put (user, dir); 

} 

} 

} 

public static String getUserDirectory (String name) 

String path = basePathStore . getProperty (name) ; 

if (path != null) 
return path; 

5 else 

« return m_props .getProperty ( "Def aultBasePath" ) ; 

0 } 

I * * 

U * Determines if this context has optional user-editable properties. This context does 
'--1 * -- the LDAP server. 
^ * 

^ * ©return Boolean true to indicate that this context does have optional properties. 
* 

□ * ©author meyerwil 

n */ 

~ public boolean hasOptional Props () 

1 < 

II return false; 

3 > 

^ J * * 

* Determines if the context has required user-editable properties. This context does 

- - the 

* SMTP server. 
* 

* ©return Boolean true to indicate that this context does have required properties. 
★ 

* ©author meyerwil 

*/ 

public boolean hasRequiredProps () 
{ 

return true; 

} 

/ * * 

* This method indicates product information for the provider. 
★ 

* ©return A StoreProviderlnf o object containing product information. 
* 

* ©author meyerwil 
*/ 

public StoreProviderlnf o getlnfo () 
{ 

return new StoreProviderlnf o ( FileStoreProvider .MANUF_NAME , 

Fi 1 est ore Provider . MANU F__CONT , 
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FileStoreProvider . APP_NAME , 
FileStoreProvider . VERSION, 
FileStoreProvider . BUILD, 
FileStoreProvider . APP_RELEASED) 

} 
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package thinairapps .groupware - storeproviders . file; 
import java .util . StringTokenizer ; 
public class HTMLRipper 



{ 



private final static String SPECIAL_CHARS [] 



{ 11 &nbsp 
"& " 
"&#174" 
"&" 
" &#183" 
M &#4 6; " 

"&gt ; " , 

"&lt ; " , 
ii ti 

«\n«, 

"\r"} ; 



// no semicolon 



* remove anything that starts with a < and ends with a > 

* ©param htmlCode source HTML 
*/ 

public static String removeTags (String htmlCode) 
StringBuffer results = new StringBuf fer () ; 
StringTokenizer st = new StringTokenizer (htmlCode ,"< M ) ; 
String text = null; 
while (st . hasMoreTokens ( ) ) { 
text = st . nextToken ( ) ; 

text = text . substring (text . indexOf ( M >" ) +1) ; 



} 



if (text . length ( ) > 0 && ! text . equals ( " \n" ) && ! text . equals ( " " ) ) 
results .append (text + " " ) ; 



return results . toString () ; 



/ * * 

* remove anything that starts with a < and ends with a > 

* ©param htmlCode source HTML 
*/ 

public static String removeTagsExcept (String htmlCode, String [] tags) 

StringBuffer results = new StringBuf fer ( ) ; 

StringTokenizer st = new StringTokenizer (htmlCode ,"<") ; 

String text = null; 

String tag = null ; 

while (st . hasMoreTokens () ) { 

text = st . nextToken () ; 

tag = text . substring (0 , text . indexOf (">")) . trim( ) . toLowerCase ( ) ; 
for (int i - 0; i < tags. length; i++) 



{ 



} 



if (tag. startsWith (tags[i])) 

results . append ("<" + tag + ">"); 



text = text . substring (text . indexOf (">") +D ; 
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if (text .length () > 0 && ! text . equals ( " \n" ) && ! text . equals ( " ")) 
results . append (text ) ; 

} 

return results . toString () ; 

} 

/ * * 

* remove the text specified in SPECIAL_CHARS 
*/ 

public static String removeSpecial (String htmlCode) { 

int numSpecial = SPECIAL_CHARS . length; 
int indexes!] = new int [numSpecial] ; 

int len = htmlCode . length () ; 
int newLen = len; 

char dummy = (char) 0; 

char buf t ] = htmlCode . toCharArray ( ) ; 

int i, j, k, index ; 

outer: 

while (true) { 

k = 0; // count how many SPECIAL_CHARS have been found 

inner : 

for (i = numSpecial; --i >= 0; ) { // look through all the SPECIAL_CHARS 

if (indexes [i] == -D { // no more SPECIAL to be found 

if (++k == numSpecial) // have ALL SPECIAL been found? 

break outer; 
else // skip and keep LOOKING 

continue inner; 

} else { 

// look for more of SPECIAL 

index = htmlCode . indexOf (SPEC I AL_CHARS [i] , indexes [i] ) ; 

if (index == -1) { // no more SPECIAL 

indexes [i] = index; // mark as all done 
continue inner; // continue to next 

} 

} 

// replace all chars in SPECIAL with dummy char 
for (j = SPECIAL_CHARS [i] . length () ; - - j >= 0; ) { 

buf [ index + j ] = dummy; 

- -newLen ; 

} 

indexes [i] = index + 1; // advance indexes [i] to avoid repeats 



} 



} 



// FIXME FIXME FIXME 

// use newLen and array-based implementation 
// 

StringBuffer sb - new StringBuffer (newLen) ; 

// copy all non-dummy chars into the return array 
for (i - 0; i < len; i++) { 
if (buf [i] == dummy) 
continue ; 

else 

sb . append (buf [i] ) ; 

} 
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return sb . toString ( ) . trim ( ) ; 

} 



. J * * 

* remove pairs of opening and closing tags 
*/ 

public static String removeTagPairContent (String htmlCode, String start, String end) { 

int i = 0; 

int endldx = 0; 

while {(i = htmlCode. indexOf (start, i) ) > 0) { 
endldx = htmlCode . indexOf (end, i) ; 
if (endldx == -1) 
break ,- 

htmlCode = htmlCode . substring ( 0 , i) +htmlCode . substring (endldx+end . length () , yl 
- htmlCode . length ( ) ) ; 

i = htmlCode . indexOf (start , i) ; 

} 

return htmlCode; 

} 

P /** 

33 * remove all script tags from HTML 
A * ©param htmlCode source HTML 
r */ 

™ public static String removeJS (String htmlCode) { 

y htmlCode = removeTagPairContent (htmlCode , n <script" , "</script > n ) ; 

^ htmlCode = removeTagPairContent (htmlCode , "<!-", "->"); 

return htmlCode; 

I } 

=J / ** 

p. * remove all blank lines and new lines 
==* * ©param text source String 
"? */ 

~ public static String removeBlankLines (String text) { 
StringBuffer output = new StringBuffer {); 
StringTokenizer st = new StringTokenizer (text, "\n") ; 
String line; 

if ( ! st -hasMoreTokens ( ) ) { 
output . append (text ) ,- 

} else { 

while (st -hasMoreTokens () ) { 
line = st . nextToken ( ) ; 
line = line.trimO; 

if (line.lengthO > 0) 

output . append ( line + "\n" ); 

} 

} 

return output . toString () ; 

} 
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public static String processPage (String pageText) 



pageText = remove JS (pageText ) ; 
pageText = removeTags (pageText) ; 
pageText = remove BlankLines (pageText ) ; 
pageText = removeSpecial (pageText) ; 

return pageText ; 



} 



# » 

README . tXt 



TextFile Sample Groupware provider 
wireless SDK for ThinAir Server 



About This Sample 



This sample Groupware Provider is compatible with any of the ThinAir Groupware 
Connectors included in the standard server installation, it demonstrates 
a simple Provider that reads data out of a text file data store, caches it, 
and services requests from the cache. The provider currently ignores all of 
the request parameters and returns all messages in the cache with every 
request. It could easily be modified to pay attention to the 'max 1 member of 
the itemRequest or the request bounds and filter the returned data in some way. 
consult the ThinAir Platform API for information on the userDataRequest / 
UserDataResponse protocol . 



Requi rements 



This sample requires the following SDK jars: 

i.J * platform. jar 

- O 

.rr * groupware. jar 

^ "finis sample does not require any other external apis. 



Sample Files 



^=¥his sample consists of the following file tree: 

■a* provider_integrated.ini and provider_standalone.ini - two possible config 

ij files, one of which should be copied into provider.ini 

!fj sourceFile.dat - a delimited text data file 

]Z sourceFileKey.txt - template for the data file format 

J3 TextFileProvider. jar - compiled Java code 

f=is \src - java source files 



Building the sample 



Compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your classpath. 

install the compiled sample code and provider.ini configuration file into a 
subdirectory of the ThinAir Server's \Providers subdirectory, given a name 
of your choice. If you are running TextFileProvider as an in-memory 
StoreProvider copy provider_integrated.ini into Providers/provider.i ni . if you 
are running TextFileProvider as a standalone StoreProvider, copy 
provider_standalone into Providers\provider.ini before you begin, within 
provider.ini under the [Provider Settings] heading, the SourceFile setting 
should point to the installation directory of the sourceFile.dat file on 
the machine hosting the Provider. 



Start the ThinAir Server; it will load the sample code and begin executing it. 
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README . txt 

Last updated: 11. 17. 2000 
Copyright 1999, 2000 ThinAirApps inc 




page 2 



<username> I <password> 

# Each message is encoded in 

<sender's display name>| 

<sender*s email address>| 

<sent date in M-d-y h:mm a 

<subject> | 

<body> 



sourceFi 1 eKey . txt 
a block like the one below 

f ormat> I 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERNS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE - ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Thinairapps Imports 

import thinairapps . groupware . api . * ; 

import thinairapps. groupware -api .actions . * ,- 

import thinairapps -groupware . api .bounds . * ; 

import thinairapps .groupware . api . exception - * ; 

import com. thinairapps .platform. provider . * ; 
import com. thinairapps . platform . exception . * ; 

import com. thinair .utils . * ; 

//Standard Java Imports 
import j ava . text . * ; 
import j ava . ut i 1 . * ; 
import j ava . net . * ; 
import j ava . io . * ; 



/ * * 

3* @(#) TextFileProvider . java 
~ * 

}?* Read a PIPE-delimited text file containing encoded messages 

=M* and deliver them to a Connector as Groupware objects 

4*/ 

fgublic class TextFileProvider implements StoreProvider 
« private static int counter = 0 ; 

g private Supportedltems support edl terns ; 

private String username, password ; 

private Vector messages, - 
□ private SimpleDateFormat dateFormatter; 
f\ private int instanceNumber ; 

2 //Error code from the ThinAir Groupware Access application. 

//Provider writers may define error codes for their own applications 
"l public static final int ERROR_AUTHENTICATION_FAILED = 4310; 



/* * 

* build a new TextFileProvider 

* for the simple web provider there is nothing to do here 
*/ 

public TextFileProvider ( ) 

{ 

instanceNumber = ++counter; 

System. out -println ( "Starting TextFileProvider "+instanceNumber+ " . . .") ; 
dateFormatter = new SimpleDateFormat ( "M-d-y h:mm a"); 

// this cache holds all the messages in the source file 
messages = new Vector () ; 

} 



j * * 

* Load the source file 

* Parse its contents into a username, password, and Message objects 

* authenticate the user's login based on username/password 
* 

* ©return set of supported items 
*/ 

public Supportedltems connectUser (StoreProviderLogin login, StoreProviderContext 
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context) throws ProviderExcept ion 

{ 

try 

// this will also obtain username and password info from the file 
loadSourceFile ( ( (TextFileProviderContext ) context) .props) ; 

} 

catch (Exception e) 

^ System. out . print In ("Caught an exception logging in: " + e.getMessage () ) ; 

//In a actual application, you would define your own error code 

throw new ProviderExcept ion (e . getMessage ( ) , ProviderExcept ion . NO_ERROR_CODE) ; 

} 

// authenticate login 

if (! authenticateUser (login) ) 

//In an actual application, you would define your own error code 
throw new Authenticat ionFailedExcept ion (ERROR_AUTHENTICATION_FAILED) ; 

// prepare the return object 

supportedl terns = new Supportedltems ( ) ,- 

String name = TextFileProviderContext . APP_NAME ; 

String location = null; 

p ^ry 

*0 location = InetAddress . getLocalHost ( ) .getHostAddress ( ) ; 

H --J .catch (Exception e) 

E { 

= location = " localhost " ; 

w } 

// support no actions 
^ short actions [] = new short [0] ; 

Supportedl tern item = new Supportedl tern ( I temTypes . MESSAGE , name, location, actions) ; 
supportedltems .addl tern (item) ,* 

// return the completed Supportedl tern set 
return supportedltems; 




/ * * 

* disconnect a user - nothing to do for this simple Provider 
* 

*/ 

public void disconnectUser { ) 

System. out -println ( "TextFileProvider "+instanceNumber+" shutting down."); 

} 



/ * * 

* not implemented for this simple Provider 
*/ 

public UserDataLocations getLocations (UserDataLocationRequest req) 

^ UserDataLocations Iocs = new UserDataLocat ions ( I temTypes . MESSAGE , new String[0]); 
return Iocs; 

} 
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* UserDataActions tell the provider to modify the backend data store in some way 

* This simple Provider does not support any actions 
* 

* ©param action describes the requested action 

*/ . . x 

public UserDataActionResponse doUserDataAction (UserDataAction action) 

{ 

return null; 

} 



/ * * 

* The source file was loaded and cached in connectUser ( ) 

* Service requests for messages here 
* 

* ©param request represents the UserData request object 
*/ 

public UserData getUserData (UserDataRequest request) 

ItemRequest itemReq = request . requests [0] ; 

// prepare the return object 
UserData ud = new UserData ( ) ; 

ud. responses = new ItemRequestResponse [ 1 ]; 
ud. responses [0] = new ItemRequestResponse ( ) ; 
ud- responses [0] . request = itemReq; 

short type = itemReq . itemType ; 

// verify that the request is of the correct itemType 
if (type != ItemTypes. MESSAGE) 

throw new Runt imeExcept ion ( "Unknown item request type: "+type) ; 



^ // load the responses [0] .items Vector with Message objects from the messages cache 

ud. responses [0] . items = new Storeltems ( ) ; 

Xi // ignore bounds and max 

~ // return entire cache every time 

r ± int numMessages = messages . size () ; 

J1 for (int i = 0; i < numMessages; i++) 

□ ud. responses [0] . items .addElement ( messages . el ementAt ( i ) ); 

^ // N.B. if we had implemented bounded requests by filling in the responses [0] . bounds kf 

array 

// we could ask for a subset of the cached messages, and page back and forth within 
the 

// cache, retrieving the first 5, then the next 5, ect. 

// for now, make the Connector assume that the entire cache is returned each time 
ud. responses [0] . items . setlsLastAvailable (true) ,- 

// return completed response object 
return ud; 

} 



/* 

* Read and parse the source file 

* Determine username and password 

* Generate Message objects 
*/ 

private void loadSourceFile (Properties props) throws Exception 

{ . . 

//Get the SourceFile value from provider. mi 

String sourceFile = props . getProperty ( "SourceFile" ) ; 
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//Separate the sourcePath into filepath and fileName 
//look for the last instance of the \ String 
String lastDivider = "\\"; 

//Get the divider's index in the String 

int lastlndex = sourceFile . lastlndexOf ( lastDivider) ; 

//Get the sourcePath 

String sourcePath = sourceFile . substring ( 0 , last Index+1 ) ; 
//Get the file name 

String fileName = sourceFile . substring ( lastlndex+l , sourceFile . length ()) ; 
byte buf [] = null ; 

//File file = new File ( sourceFile) ; 

File file = new File ( sourcePath, fileName); 

buf = new byte [ (int) f ile . length ( ) ]; 

try 

FilelnputStream f is = new FilelnputStream ( file ) ; 

while (f is. read (buf ) != -1) ; 
3 f is . close ( ) ; 

~ } catch (Exception e) { 

y throw new Exception ( "Cannot find / read source file: "+f ile . getAbsolutePath ()) ; 

0 } 

System. out .println ( "TextFileProvider It + instanceNumber+ " loading data from "+file. * 
^ getAbsolutePath ( ) ) ,- 

y // buf now contains full file data 

t% String content = new String (buf); 

_ // use the Tokenizer to parse the data into Message objects 

5 parseSourceFile (content ) ; 

h } 



/* 

* Parse the source data 

* Extract username / password 

* Generate Message objects for the rest 
*/ 

private void parseSourceFile (String content) throws Exception 

{ 

Tokenizer tok = new Tokenizer (content, ' | ') ; 

username = tok . next Token ( ) ; 
password = tok . next Token () ; 

Message msg = null; 
GroupwareUserSMTPAddress address ; 
while ( tok . hasMoreTokens ( ) ) 

{ 

// displayName , email address 
msg = new Message () ,- 

address = new GroupwareUserSMTPAddress ( tok . nextToken () , tok . nextToken ( ) ) ; 
msg . set From (address) ; 

msg. setReceivedDate ( dateFormatter . parse ( tok . nextToken ( ) ) ); 
msg . setSubj ect ( tok . nextToken ( ) ); 
msg.setBody( tok . nextToken ( ) ); 



// add to global messages Vector 
messages . addElement (msg) ; 
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} 

System. out .println (messages. size () +" Messages parsed by TextFileProvider "+ 
instanceNumber) ; 

} 



/* 

* authenticate the login credentials passed to connectUser ( ) 

* by checking against username/password stored in source file 
*/ 

private boolean authenticateUser (StoreProviderLogin login) 
{ 

if {! login .name . equals ( username )) return false; 

if (! login .password . equals ( password )) return false; 

System. out . println ( "TextFileProvider "+instanceNumber+" authenticates M +username) ; 
return true; 

} 

} 



C : \TASS\ . . \Providers\TextFile\src\TextFileProviderContext . java 

/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 



//Thinairapps Imports 

import thinairapps .groupware . api . * ; 

import thinairapps .groupware .api . actions . * ; 

import thinairapps .groupware .api . bounds . * ,- 

import thinairapps .groupware .api . exception. 1 

import com. thinairapps . platform . provider . * ; 

import com. thinairapps .platform . exception . * , 



import com. thinair .utils . 

//Standard Java Imports 
import java .util . * ; 



* @ (#) TextFileProvderContext 
* 

* provides static information for and about the TextFileProvider 
public class TextFileProviderContext extends St ore Provider Context 



II Version info 

protected static final String VERSION 

protected static String APP_NAME 

protected static final String MANUF_NAME 

protected static final String MANUF_CONT 

protected static final String BUILD 

protected static final Date AP P_RE L E AS E D 

protected Properties props; 



"1.2"; 

"TextFileProvider" ; 
"ThinAirApps" ; 
"www.ThinAirApps . com" ; 

= " 1 " ; 
new Date ( ) ; 



/ * * 

* Determines if the context has optional user-editable properties. Implementors should 

* return true if they can offer optional Properties to the user, but do not require «r 

these 

* properties to be set in order to correctly serve user connections. StoreProviders maytf 

have 

* both property types . 
* 

* ©return A boolean indicating whether or not the context has optional properties. 
*/ 

public boolean hasOpt ional Props ( ) { return false; } 



I * * 

* ©return ProviderObjectSet indicating the friendly and class names of Storeltem 

subclasses 

* understood by this StoreProvider . 
*/ 

public StoreProviderType getTypeO { return new StoreProviderType ( "thinairapps .groupware. / 
api " ) ; } 



/** 

* Called by a client to ask for product information on the provider. 

* ©return StoreProviderlnf o containing information on this provider. 
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*/ 

public StoreProviderlnf o getlnfo {) 

return new StoreProviderlnf o ( MANUF_NAME, 

MANUF_CONT, 
APP_NAME , 
VERSION, 
BUILD, 

APP_RELEASED ) ; 

} 



/ * * 

* Tells the context to update its property set. It will throw a \£ 

SPInvalidContextPropsException 

* if it does not accept the properties. 

* Oparam props The new set of properties to commit. 
*/ 

public void updateProps (Properties p) 

if (p .getProperty ( "SourceFile" ) == null) 

throw new Runt imeExcept ion ( "Cannot find property SourceFile in provider.ini") ; 

props = p; 

} 



j -k * 

* ©return A boolean indicating whether or 
*/ 

public boolean hasRequiredProps ( ) { return 



not the context can offer required properties . 
true; } 



3 * Retireves a Context Propert ies object containing user-editable required and optional 
?% * properties 

fj * ©return ContextProperties object containing user-editable required and optional 
properties. 

H */ 

~~ public ContextProperties getPropsO 

— Properties required = (props == null) ? new Properties () : (Properties) props. clone ^ 

() ; 

return new ContextProperties ( new Properties () , required); 

} 

} 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE . ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Standard Java Imports 
import java.util.*; 



* @ (#) Tokenizer . java 
* 

* Simple tokenizer that, unlike StringTokenizer , will return an empty 

* String when two tokens appear right next to each other 
*/ 

public class Tokenizer 
{ 

private static final String BLANK = " " ; 

private char DELIM; 

private int currentPosition; 

private int maxPosition; 

private String str; 



* buld a new Tokenizer for the given String with the given delimiter 

* ©param s source String 

* ©param d delimiter character 
*/ 

public Tokenizer (String s, char d) 

{ 

str = s; 
DELIM = d; 

currentPosition = 0; 
maxPosition = str . length () ; 

} 



/ * * 

* Returns the next token from this string tokenizer. 
* 

* ©return the next token from this string tokenizer - may be " " if two 

* DELIMs next to each other appear in the String 

* ©exception NoSuchElementException if there are no more tokens in this 

* tokenizer 1 s string. 
*/ 

public String nextTokenO 

{ 

int start = currentPosition ; 

if <++currentPosition > maxPosition) throw new NoSuchElementException { ) ; 

if (currentPosition == maxPosition || ( str . charAt (currentPosition) == DELIM)) 
return BLANK; 

// else .... 

if (str .charAt (start) == DELIM) ++start; 

while ((currentPosition < maxPosition) && (str . charAt (currentPosition) !- DELIM) ) 
currentPosit ion++ ,- 



} 



return str . substring ( start , currentPosition) . trim () ; 
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/ * * 

* Returns the same value as the <code>hasMoreTokens</code 

* method. It exists so that this class can implement the 

* < code >Enumeration</ code > interface. 
* 

* ©return <code>true</code> if there are more tokens; 

* <code>f alse</code> otherwise. 

* ©see java .util - Enumeration 

* ©see java .util . StringTokenizer#hasMoreTokens ( ) 
*/ 

public boolean hasMoreTokens ( ) 

return (currentPosition < maxPosition) ; 

} 
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Send Email Sample Groupware connector 
wireless SDK for ThinAir Server 



About This Sample 

This sample Groupware Connnector is compatible with any of the ThinAir 
Groupware Providers included in the standard server installation. It 
demonstrates how to write a simple Connector using the ThinAir Groupware API 
that allows a user to create and send an email message. 

The Send Email Connector first displays a ui prompting the user for the 
from, subject, and body elements of the email message, it then reads the 
user's login credentials from the connector.ini file. The connector could 
easily be modified to prompt for thi s i nformation , as the Getltems Groupware 
Connector does. It then connects to the message store, creates a Groupware 
Object representing the email message, and sends it. it then logs the user 
off. This example could easily be modified to create items of other types, 
e.g. Event or Task. 

N.B. This sample connector is written for wml devices ONLY'. 



;Jfequi rements 



T§iis sample requires the following SDK jars: 

- xz. 

\\\ * platform. jar 
•~J * taglib.jar 
W * groupware. jar 

"This sample does not require any other external apis. 



i^ample Files 

i^fhis sample consists of the following file tree: 
connector.ini - connector configuration file 
senditemsconnector .class - compiled Java code 
/src - java source files 



Building the Sample 



Compile the sample code using the Java compiler of your choice. The included 
MAKE script will compile the sample using the JDK, if available. 

install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir Server's /Connectors subdirectory, given a name 
of your choice. 

Start the ThinAir Server, it will load the sample code and begin executing it. 



using the Sample 



wait until the Thi nAi rserver has started and the Send Email Groupware Connector 
has been loaded and initialized. From a wml device, enter the IP address 
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listed as the value for ApplicationPath in connector.ini (your Thi nAi rserver IP 
address), followed by /samples/sendemail . For a machine with IP address 
111.222.12.34 this would be: 

http : //111 . 222 . 12 . 34/sampl es/sendemai 1 

Follow the on-screen instructions. 



Last updated: 11.13.2000 
Copyright 1999, 2000 ThinAirApps inc. 
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/ * * 

* @ (#) SendEmailConnec tor . java 
* 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF * 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 

//core ThinAir Server API functionality 

import com. thinairapps . platform. device . * ; 
import com. thinairapps .platform. connector. * ; 
import com. thinairapps .platform. exception . * ; 
import com. thinairapps . platform. provider . * ,- 

//rendering packages used to build markup 
import com. thinairapps . tag . * ; 
import com. thinairapps . tag .wml .* ; 

// the groupware packages 
13-mport thinairapps .groupware . api . * ; 
^import thinairapps .groupware . api .actions . * ; 
J3.mport thinairapps .groupware . api .bounds. * ; 
Mlmport thinairapps .groupware . api . exception . * ; 

.^import java.util . * ; 
i s : import j a va . i o . * ; 

m 

"7** 

!„ * This is a simple sample whose purpose is to illustrate the use of the ThinAir Groupware 
= =J Library for creating groupware items. 

|fl* This sample renders WML. It prompts the user to enter to address, a subject and a body, 
and then procedes 

:!f * to log them onto their message store, create (send) the item and then log them off again. \£ 

W- This sample could easily be * 

ij * modified to create items of other types, eg. Event or Task 

S.-JL * 

* For a comprehensive reference of the Groupware Library see the ThinAir Groupware javadocs. 
*/ 

public class S endEma i 1 Connec t or implements Connector 

{ 

//The friendly name of this sample app 
protected String appName ; 

//Our access point to the services of ThinAir Server 
protected ConnectorAccess connectorAccess ; 

protected String provider; 

protected String userName; 

protected String password; 

protected String host; 

protected String fromDisplay; 

protected String fromEmail; 

private final static String SUPPORTED_ITEMS_CACHE_KEY = "supports"; 



/ * * 

* initO is called by the ThinAirServer when the Connector is loaded. It provides the * 
connector with 
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* resources it needs to interact with the ThinAirServer . 

* For more information about the Connector interface, see the javadocs for the ThinAir * 

Server API 

* 

* ©param applicationName is a String derived from connector.ini. 

* ©param applicationPath is a String dervid from connector.ini. We don't need this for 

this sample . 

* ©param connectorProps is a Properties list containing developer assigned 

connector- specif ic properties. 

* ©param connectorAccess is our access point to the services provided by ThinAir Server. 

* ©param ApplicationLog is used for logging 
*/ 

public void init (String applicationName, String applicationPath, 

Properties connectorProps, ConnectorAccess connectorAccess, com. 
thinairapps .platform, connector .ApplicationLog al) throws 
ConnectorlnitException { 
this.appName = applicationName; 
this . connectorAccess = connectorAccess; 

// get the all required variables from the properties list (connector.ini). make sure/ 

you set this up before 
//running this example 

provider = connectorProps .getProperty ( "Provider" ) ; 

// your user name 
m userName = connectorProps . getProperty ( "UserName" ) ; 

// your password 

password = connectorProps .getProperty ( "Password" ) ; 
// the ip of your message host, note: if using IMAP or POP 

// the ip of the smtp server you will be using is in the providers provider.ini file 
host = connectorProps .getProperty ( "Host" ) ,- 

// your display name 

fromDisplay = connectorProps .getProperty (" FromDisplay" ) ; 
// your email address 

fromEmail = connectorProps . getProperty ( "FromEmail " ) ; 

if (provider . length ( ) ==0 || userName . length ( ) == 0 | | password . length ( ) == 0 | | 
host . length{ ) == 0 | | fromDisplay . length ( ) == 0 | | fromEmail . length ( ) == 0) 
throw new ConnectorlnitException ( "connector . ini must have entries for Provider, 
UserName, Password, Host, FromDisplay, and FromEmail"); 

} 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevices ( ) returns an array containing 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used / 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile * s getName() method. 
* 

* For more details about device detection and handling see the DeviceDetective sample / 

connector and the 

* ThinAir Server Developer Guide. 
* 

* ©return an array of Strings representing the friendly names of the devices this / 

Connector supports. 

*/ 

public String [] getDevices () 

{ 

String deviceType = "TA WAP" ,- 
String [] deviceTypes = JdeviceType} ; 
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return deviceTypes; 

} 



/**The handle method implements the core logic of a Connector. It takes an incoming 
request from a 

* particular device, and returns an appropriate response. This method is called whenever ^ 

the server 

* receives a request from a type of device that the Connector indicates it supports, 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of y? 

the Connector 

* to interpret the request and generate an appropriate response. 
* 

* The server will pass a Device object containing as much information as possible into ^ 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed 

information 

* on the capabilities of the particular device making the request. 
* 

* ©param props a set of name value pairs corresponding to the HTTP request parameters 

from the device. 

* ©param device a Device object created in the image of the actual device making this 

request . 

□ * ©param result a reference to the OutputStream that will be returned to the device. 

0 */ 

rr public void handle (Properties props, Device device, OutputStream result) throws 
& IOException { 

'"4 

ff String resultString = null; 

//get the 'action' parameter from the request. This is an HTTP param we define to ^ 
M determine what action 

2 //to take when we get a request. 
String action = props . get Property ( "act ion" ) ; 

=J String sessionld = null ,- 

if (action == null) 

11 // if this is the first hit (or any request for the main deck) 

3 // build a deck that lets the user enter information. 
^ resultString = renderCreateMesage { ) ; 

} else if (action. equals ( "createMsg" ) ) 

{ 

// they have already entered the information, get the messages 
String to; 
String sub; 
String body; 

// get the required parameters 

// the mail host we will be accessing fom the HTTP params 
// the recipient 

to - props .getProperty ( " tolnput ") ; 

// the message subject 

sub - props .getProperty ( "sublnput" ) ; 

// the message body 

body = props .getProperty ( "body Input ") ; 

try 
{ 

//we have all the information we need to logon and send the message 
// log you in to teh message store 

sessionld = loginUser (provider , host, userName, password) ; 
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// get the default location from the supported Items returned from Login thattf 

we stored in the session cache 
String def aultLocation = getDef aultLocat ion (I temTypes .MESSAGE, sessionld); 

// send the message 

sendMessage (def aultLocation, sessionld, fromDisplay, fromEmail, to, sub, 
body) ; 

// log them off 

connectorAccess . getStoreProvider (sessionld) . disconnectUser ( ) ; 

// then delete the session 
connectorAccess . deleteSession ( sessionld) ; 

// now render a screen indication success 

resultString = renderSuccess ( "Message Successfully Created") ; 
} catch (Exception e) 

// need to do error checking here, we simply display the error message and 
provide a link 

// back to the welcome screen, a larger app would handle each error * 

seperatley and navigate the 
// user accordingly 

resultString = renderException (e . getMessage 0); 

} 



byte[] resultBytes = resultString . getBytes () ; 
result . write (resultBytes) ; 



/ * * 

* This method logs the user in to their message store 
* 

* ©param providerName the name of the provider being used to access the message store. 

* ©param host the ip or server name of the message store. 

* ©param userName the user name of the account being logged onto. 

* ©param password the password for this user. 

* ©return a providerSessionID if success, otherwise an error will be thrown. 
*/ 

protected String loginUser (String providerName, String host, String userName, 

String password) throws Exception { 

String SID = null; 
try { 

// Create a new Session with the specified provider and returns a unique Session 
ID. 

SID = connectorAccess . createProviderSession (providerName); 

// Get the StoreProviderProxy associated with the session we just created, 
// this is what is used to interact with the Provider 

StoreProviderProxy spProxy = connectorAccess .getStoreProvider (SID); 

// Create a StoreProviderLogin object, this defines the action the Provider will ^ 
execute 

StoreProviderLogin login = new StoreProviderLogin (userName, password, host) ; 

// use the StoreProviderProxy to login. The provider returns the items it 

supports and the actions on them 
Supportedltems supports = spProxy . connectUser (login) ; 

// we cache the supported Items because we know we will need them later 
connectorAccess. getSessionCache (SID) .put (SUPPORTED_ITEMS_CACHE_KEY, supports) ; 
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} catch (NoSuchProviderException e) { 

throw new Except ion ( n No Provider named " + provide rName+ " was loaded by the ThinAirtf 
Server" ) ; 



} 

return SID; 



* This method sends a message. It assumes you are in the logged in state 
* 

* ©param location the location the message is to be created in, this does not matter 

when creating a message, however if creqating 

* a post or other item we could specify the location the item be placedi^ 
in. 

* ©param SID a valid session Id, the user must already be authenticated . 

* ©param fromDisplay the items storelndex to start at, this may be null if starting at * 

the beginning 

* ©param fromEmail the maximum number of messages to retrieve. 

* ©param to the recipient of the message you are sending. This can be their email * 

address, or you can have the server try and identify them either throught LDAP if 
supported and activated or through the message stores internal name resolution system 

* ©param sub the subject of the message you are sending. 

* ©param body the body of the message you are sending. 
*/ 

protected void sendMessage (String location, String SID, String fromDisplay, String 
fromEmail , 

String to, String sub, String body) throws Exception 

{ 

Message msg = new Messaged ; 

GroupwareUserSMTPAddress fromAddr = new GroupwareUserSMTPAddress (fromDisplay, 

fromEmail) ; 
msg. set From (fromAddr); 

// the recipients are always an array of GroupwareUserSMTPAddress s ' we are assuming 

for this example that there will only be one 
// feel free to tokenize a list of comma or semi-colon delimited list of recipients 

here 

GroupwareUserSMTPAddress [] toAddrs = new GroupwareUserSMTPAddress [1] ; 
if (to.indexOf ("©") > 0) 

// it is a valid email address 

toAddrs [0] = new GroupwareUserSMTPAddress (null , to); 

else 

// not a valid address, leave it up to the Provider or mesasge store to validate 
toAddrs[0] = new GroupwareUserSMTPAddress (to, null); 

msg . setRecipients (Message . RecipientType .TO, toAddrs) ; 

// if we suppported cc 
/* 

GroupwareUserSMTPAddress [] ccAddrs = new GroupwareUserSMTPAddress [1] ; 
if (to. indexOf ( ,! @ n ) > 0) 

ccAddrs [03 = new GroupwareUserSMTPAddress (null , cc) ; 

else 

ccAddrs [0] = new GroupwareUserSMTPAddress ( cc , null); 

msg . setRecipients (Message . RecipientType . CC, ccAddrs) ; 
*/ 

msg . setSubject ( sub) ; 
msg . setBody (body) ,- 



// the location the message is to be created in, this does not matter when creating atf 
message, however if creating a 
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// post or other item we could specify the location the item be placed in. 
msg . setLocationlnStore (location) ,- 

StoreProviderProxy spProxy = connectorAccess . getStoreProvider (SID) ,- 

AddNewGroupwareltem addAction = new AddNewGroupwareltem (msg) ; 
spProxy . doUserDataAction (addAction) ; 



return ; 

} 



I * * 

* A utility method that simply looks in the session cache for the Supportedl terns , 

extracts the 

* default location for the specified item type and returns it 
* 

* ©param SID a valid session Id. 

* ©param itemtype the type of item. 

* ©return the default location. 
*/ 

private String getDef aultLocation (int itemType, String SID) throws * 
NoSuchSess ionExcept ion 

{ 

// look for Supportedl terns in the cache 

Supportedl terns sis = ( Supportedl terns) connectorAccess . getSessionCache (SID) .get 

(SUPPORTED_ITEMS_CACHE_KEY) ; 
Enumeration elem = sis .getltems ( ) ; 
Supportedltem si = null; 

// cycle through them until we find the type we need and return it 
while (elem.hasMoreElements () ) 

si = (Supportedltem) elem. nextElement () ; 

if (itemType == si . getType ( ) ) 

{ 

return si . getDef aultLocation () ; 

} 

} 

//itemType not found, this should never happen 
return null; 

} 



* This method renders a deck with several cards including a welcome card and card for 

entering information. . . 

* 

* ©return the rendered deck. 
*/ 

private String renderCreateMesage ( ) 

{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//create the first card in the deck and give it the ID »cl' 
DisplayCard cardl = new DisplayCard ( "cl " ) ; 
//create a centered Paragraph 

Paragraph p = new Paragraph (Paragraph .ALIGN_CENTER, Paragraph . MODE_WRAP) ; 



p.addChild(new Text ("Send Email")); 
p . addChild (new Break ( ) ) ; 

p .addChild (new Text ( "Sample Connector") ) ; 
//add the Paragraph to the card 
cardl . addParagraph (p) ; 
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p = new Paragraph ( Paragraph . ALIGN__LEFT, Paragraph . MODE_WRAP) ; 

//a link to the second card 
String href = M ?#compose" ; 

//make a Go task with the href 

Go go = new Go {href , true, Go .METHOD_GET) ; 

//create the Anchor with the Go task 

Anchor anchor = new Anchor (go, new Text ( "Login" )) ; 

//add the anchor to the Paragraph 
p. addChild (anchor) ; 

//add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//add the first card to the deck 
deck. addCard( cardl) ; 

Labeledlnput tolnput = new Labeledlnput ( " to" , "TO:"); 
Labeledlnput sublnput = new Labeledlnput (" sub" , "SUBJECT:"); ^ 
Labeledlnput bodylnput = new Labeledlnput ( "body " , " BODY : " ) ; 

□ Labeledlnput!] inputs = {tolnput, sublnput, bodylnput}; 

^ //set the URL params to the values in the WML variables &, the escape sequence 

— for ampersand, delimits name- 

=J //value pairs. $ is used to dereference a WML variable. A random number is used so 

n; the next time you get to this page you will actually 

//be hitting the server rather that retrieving from the phone's cache 

href = "?action=createMsg& toInput = $ (to) & sublnput = $ (sub) & bodylnput \l 
'4 =$ (body) &amp ,- rnd= " +Math . random ( ) ; 

MultiplelnputCard mic = new Mult iplelnputCard ( "compose" ) ; 



mic.buildCard(href , "Send" , inputs , Go .METHOD_GET) ; 
deck. addCard (mic) ; 

String resultString = deck . render () ; 
return resultString; 

} 



* This is a simple exception rendering method. 
* 

* ©param message the message to be presented to the user 

* ©return the rendered WML deck 
*/ 

private String renderException (String message) 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( ) ; 
Paragraph p = new Paragraph ( ) ; 

p. addChild (new Text (message) ) ; 
p. addChild (new Break ()) ; 

String href = " ?rnd= " +Math . random () ; 

Go go = new Go (href , true , Go . METHOD_GET) ; 

Anchor anchor = new Anchor (go, new Text ("Start again...")); 



p. addChild (anchor) ; 
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card.addParagraph (p) ; 
deck. addCard (card) ; 

String resultString = deck . render () ; 
return resultString ,- 



/ * * 

* This is a simple rendering method indicating success. 
* 

* ©param message the message to be presented to the user 

* ©return the rendered WML deck 
*/ 

private String renderSuccess (String message) 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard 0 ; 
Paragraph p = new Paragraph () ; 

p.addChild(new Text (message) ) / 
p.addChild(new Break ( ) ) ; 

String href = "?rnd= "+Math. random { ) ; 

Go go ~ new Go (href , true, Go . METHOD_GET) ; 

Anchor anchor = new Anchor (go, new TextC'Start again. . . " ) ) ; 

p.addChild (anchor) ; 

card.addParagraph (p) ; 
deck. addCard (card) ; 

String resultString = deck . render () ; 
return resultString; 
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Getltems sample Groupware connector 
Wireless SDK for ThinAir Server 



About this Sample 



This sample Groupware Connnector is compatible with any of the ThinAir 
Groupware Providers included in the standard server installation, it 
demonstrates how to write a simple connector using the ThinAir Groupware API 
that allows a user to log into their email store and retrieve messages. 

The Getltems Connector prompts the user for their email host, username, and 
password, if the login is accepted by the Groupware provider, the connector 
retrieves the first 5 messages in the user's inbox. This example could easily 
be modified to retrieve items of other types, e.g. Events or Tasks. 

n.b. This sample Connector is written for WML devices only. 



Requi rements 

'pjns sample requires the following SDK JARs: 
ifs * platform. jar 
"%! * taglib.jar 
fr= * groupware. jar 

Jlfihis sample does not require any other external APIs. 



i samp! e Fi 1 es 



^phis sample consists of the following file tree: 
•sJ connector.ini - connector configuration file 
?J Getitemsconnector. class - compiled Java code 
11 /src - java source files 



Building the Sample 



Compile the sample code using the Java compiler of your choice. The included 
make script will compile the sample using the JDK, if available. 

install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir Server's /connectors subdirectory, given a name 
of your choice. 

Start the ThinAir Server, it will load the sample code and begin executing it. 



using the Sample 



wait until the Thi nAi rserver has started and the Get items Connector has been 
loaded and initialized. From a WML device, enter the IP address listed as the 
value for Appl i cati onPath in connector.ini (your Thi nAi rserver IP address), 
followed by /sampl es/geti terns. For a machine with IP address 111.222.12.34 
this would be: 

h ttp : //111 . 222 . 12 . 34/sampl es/geti terns 
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README.tXt 

Follow the on-screen instructions. 



Last updated: 11.13.2000 
Copyright 1999, 2000 ThinAirApps Inc. 
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/ * * 

* @ (#) Get I temsConnector . j ava 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE X 

AGREEMENT 

* BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 

//core ThinAir Server API functionality 
import com. thinairapps .platform. device . * ; 
import com . thinairapps . platform . connector . * ; 
import com. thinairapps .platform. exception- * ; 
import com . thinairapps . platform . provider . * ; 

//rendering packages used to build markup 
import com . thinairapps . tag . * ; 
import com . thinairapps . tag . wml . * ; 

// the groupware packages 

import thinairapps . groupware . api . * ; 
ijmport thinairapps .groupware .api .actions . * ; 
i|import thinairapps . groupware . api . bounds . * ; 
■3mport thinairapps .groupware .api .exception. * ; 

ner< 

import java.util.*; 
^pjmport java.io.*; 

^**This is a simple sample whose purpose is to illustrate the use of the ThinAir Groupware * 
"tJ Library forn retrieving groupware Items. 

sp* This sample renders WML. It prompts the user to enter a mail host, a userName and a 
[ " password and then procedes 

to log them onto their message store, retrieve the first 5 messages from the default *r 
location and render the 

ill* headers. This sample could easily be modified to retrieve items of other types, eg. Event nf 

or Task, and render 
"If * them. 

»FU For a comprehensive reference of the Groupware Library see the ThinAir Groupware javadocs. 

jj^jj * 

5 public class GetltemsConnector implements Connector 

{ 

//The friendly name of this sample app 
protected String appName; 

//Our access point to the services of ThinAir Server 
protected ConnectorAccess connect or Ac cess ; 

//The provider 

protected String provider; 

private final static String SUPPORTED_ITEMS_CACHE_KEY = "supports"; 

// Max number of characters to be displayed in the subject portion of the header 

private final static int HEADER_SUBJECT_LENGTH = 10; 

// Max number of characters to be displayed in the from portion of the header 
private final static int HEADER_FROM_LENGTH = 11; 



/**init() is called by the ThinAirServer when the Connector is loaded. It provides the 
connector with 

* resources it needs to interact with the ThinAirServer . <brxbr> 

* For more information about the Connector interface, see the javadocs for the ThinAir *r 

Server API 

* 

* ©param applicationName is a String derived from connector.ini. 



jj ! n 
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* ©param applicationPath is a String dervid from connector.ini. We don't need this for 

this sample. 

* ©param connectorProps is a Properties list containing developer assigned kT 

connector- specif ic properties. 

* ©param connectorAccess is our access point to the services provided by ThinAir Server. 

* ©param applicationLog is used for Logging 
*/ 

public void init (String applicationName , String applicationPath, Properties 
connectorProps , 

ConnectorAccess connectorAccess, com. thinairapps . platform . connector . 
ApplicationLog al) throws ConnectorlnitExcept ion 

{ 

this.appName = applicationName; 

this . connectorAccess = connectorAccess; 

// get the provider name from the properties list (connector.ini) 

// You can modify this in connector.ini to access a different provider, to retrieve 
// items from a different mesage Store type, eg. IMAP or POP3 
provider = connectorProps . get Property ( "Provider ") ; 

if (provider . length ( ) == 0) throw new ConnectorlnitException ( "No Provider entry in 
connector.ini"); 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getNameO method. 
* 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 

* ThinAir Server Developer Guide. 
* 

* ©return an array of Strings representing the friendly names of the devices this 

Connector supports. 

*/ 

public String [] getDevicesO 

{ 

String deviceType - "TA_WAP" ; 
String [] deviceTypes = {deviceType } ; 
return deviceTypes; 

} 



/★★The handle method implements the core logic of a Connector. It takes an incoming 
request from a 

* particular device, and returns an appropriate response. This method is called whenever/ 

the server 

* receives a request from a type of device that the Connector indicates it supports, 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of / 

the Connector 

* to interpret the request and generate an appropriate response. 
★ 

* The server will pass a Device object containing as much information as possible into 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed \£ 

information 

* on the capabilities of the particular device making the request. 



C: \TASS\WirelessSDK\ . . \Connectors\GetItems\src\GetItemsConnector . j ava 3 

* ©param props a set of name value pairs corresponding to the HTTP request parameters 

from the device. 

* ©pararn device a Device object created in the image of the actual device making this 

request . 

* ©param result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle ( Properties props, Device device, OutputStream result) throws 
IOException 



{ 



String resultstring = null; 

//get the 'action' parameter from the request. This is an HTTP param we define to 
//determine what action to take when we get a request. 
String action = props .getProperty ( "action" ) ; 

String sessionld = null; 

if (action — null) 

// if this is the first hit (or any request for the main deck) 
// build a deck that lets the user enter information, 
resultstring = renderLoginPrompt { ) ,- 

} 

else if (action . equals ( "msgs" ) ) 

// they have already entered the information, get the messages 
String host; 
String userName; 
String password; 

// the mail host we will be accessing fom the HTTP params 
host = props .getProperty ( "host" ) ; 

// your user name 

userName = props . getProperty ( "usr" ) ; 



// and password 

password = props .getProperty ( "pwd" ) ; 

// make sure they have entered all information 

if (host==null || host. length ()==0 || userName==null || userName . length ()= = 0 
|| password==null || password . length ( ) = = 0 ) 

{ 

// if they haven't, tell them what they did wrong. 

resultstring = renderExceptiont "You must enter all information"); 

} 

else 

{ 

// we have all the information we need to logon 



try 

sessionld = loginUser (provider , host, userName, password) ,- 

// get the default location from the supported Items returned from Login 

that we stored in the session cache 
String def aultLocation ; 

def aultLocation = getDef aultLocation ( I temTypes . MESSAGE , sessionld) ,- 
/* 

In this simple example we only retrieve items from the default 
location, however ThinAir Groupware Providers provide 

a means to query a store for the available locations, then use that *r 
location to retrieve items from. This method can 

be used to access Exchange public and private folders, as well as *r 
I MAP . 
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// Get the locations 

UserDataLocationRequest udLocReq = new UserDataLocat ionRequest (); 
//udLocReq. itemType = itemTypeParamToCode (itemType); 
udLocReq. itemType = ItemTypes. MESSAGE ; 

udLocReq. maxDepth =0; // how many folders deep do we want to go?, a/ 
depth of more than 0 will include sublocation marked by the ^ 
' / ' charactger 

udLocReq . maxLocat ions = -1; 

udLocReq. root Location = rootLocation ; // null- if starting from the * 
root . 



UserDataLocations udLocations = connectorAccess . getStoreProvider * 
(sessionld) . getLocations (udLocReq) ; 

String locationst] = udLocations . getNames () ; 

// now we have an array of other locations, you may use one of these nr 
to retrieve items from. 



*/ 

// get the messages 

Storeltems messages = getStoreltems (def aultLocatipn, sessionld, null, 5, 
ItemTypes .MESSAGE) ; 

□ // log them off 

n connectorAccess .getStoreProvider (sessionld) . disconnectUser ( ) ; 

*\ // then delete the session 

'""4 connectorAccess . deleteSession (sessionld) ; 

™= 

" ; | // now render them 

resultString = renderMessageHeaders (messages) ; 

p //in this example we logged on, got the messages then logged off again. \£ 

A more complete app would 
// hold the session open between requests, and cache the retrieved y£ 
^ Storeltems in the session cache, using this to 

|1 // feed item bodies out to the client without going to the provider each 

s 1 time 



} 

catch (Exception e) 

// need to do error checking here, we simply display the error message * 

and provide a link 
// back to the welcome screen, a larger app would handle each error 

separately and navigate the 
// user accordingly 

resultString = renderException (e .getMessage ()); 

} 



byte[] resultBytes = resultString . getBytes () ; 
result . write (resultBytes) ; 



/ * * 

* This method renders a deck with several cards including a welcome card and a card for 

entering information. . . 

* 

* @param providerName the name of the provider being used to access the message store . 

* ©param host the ip or server name of the message store. 

* ©param userName the user name of the ccount being logged onto. 

* ©param password the password for this user. 

* ©return a providerSessionld if success, otherwise an error will be thrown. 
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*/ 

protected String loginUser (String providerName , String host, String userName, 

String password) throws Exception { 

String SID = null; 
try 

// Create a new Session with the specified Provider and returns a unique Session 
ID. 

SID = connectorAccess . createProviderSess ion (providerName) ,- 

// Get the StoreProviderProxy associated .with the session we just created, 
// this is what is used to interact with the Provider 
StoreProviderProxy spLite = connectorAccess . getStoreProvider (SID); 

// Create a StoreProviderLogin object, this defines the action the provider will 
execute 

StoreProviderliOgin login = new StoreProviderLogin (userName, password, host) ; 

// use the providerProxy to login. The provider returns the itens it supports 
Support edl terns supports = spLite . connectUser (login); 

//we cache the supported Items because we know we will need them later 
_ connectorAccess. getSessionCache (SID) .put (SUPPORTED_ITEMS_CACHE_KEY, supports) ; 

« catch (NoSuchProviderException e) 

-4 throw new Exception ( "No Provider named ,I +providerName+" was loaded by the ThinAirtf 

E Server" ) ; 

Jj > 

return SID; 

B } 



/** 

* This method retrieves storeltems from the Provider. There is no cache involved here. 

* This same method can be used to retrieve any item type, starting at a particular item * 

id, 

* up to a max number . 
* 

* ©param location the location or folder items are to be retrieved from. 

* ©param SID a valid session Id, the user must already be authenticated. 

* ©param startldx the items storelndex to start at, this may be null if starting at the 

beginning 

* ©param max the maximum number of messages to retrieve. 

* ©param itemtype the type of item to retrieve. 

* ©return the storeltems, this will be of length 0 if no items are retrieved, never null* 

except if exception thrown 

*/ 

protected Storeltems getStoreltems (String location. String SID, String startldx, mt maxtf 
, short itemtype) throws Exception 

{ 

ItemRequest iReq = new ItemRequest ( ) ; 
iReq. itemType = itemtype; 
iReq. itemLocat ion = location; 
iReq.max = max; 
iReq.startID = startldx; 
iReq. bounds = null; 

UserDataRequest udReq = new UserDataRequest (); 
udReq. requests = new ItemRequest [1] ; 
udReq. requests [0] = iReq,- 

// getting items of another type we shoud check in the supportedltems to verify they 

are supported by the current Provider 
Storeltems storeltems = (Storeltems) connectorAccess .getStoreProvider (SID). ^ 
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getUserData (udReq) . responses [0] .items; 

return storeltems; 



/ * * 

* A utility method that simply looks in the session cache for the Supportedl terns , 

extracts the 

* default location for the specified item type and returns it 
* 

* ©param SID a valid session Id. 

* ©param itemtype the type of item. 

* ©return the default location. 
*/ 

private String getDef aultLocation (int itemType, String SID) throws * 
NoSuchSessionException 

{ 

// look for Supportedl terns in the cache 

Supportedl terns sis = (Supportedltems) connect or Access . getSessionCache (SID) .get 

(SUPPORTED_ITEMS_CACHE_KEY) ; 
Enumeration elem = sis . getltems ( ) ; 
Support edit em si = null; 

3 // cycle through them until we find the type we need and return it 

0 while (elem.hasMoreElements ( ) ) 
S { 

~ si = (Supportedl tern) elem. nextElement () ; 

u 4 if (itemType == si .getType ( ) ) 

P { 

return si . getDef aultLocation () ; 

1 } 
~ } 

D 

//itemType not found, this should never happen 
^ return null; 

; } 



j * * 

* This method renders a deck with several cards including a welcome card and card for * 

entering login information. . . 

* 

* ©return the rendered deck. 
*/ 

private String render Log inP romp t ( ) 

{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//create the first card in the deck and give it the ID ' cl' 
DisplayCard cardl - new DisplayCard ( "cl " ) ; 

//create a centered Paragraph 

Paragraph p = new Paragraph (Paragraph . AL I GN_CENTER, Paragraph . MODE_WRAP) ; 

p.addChild(new Text ("Get Items")); 
p . addChild (new Break ( ) ) ; 

p . addChild (new TextC'Sample Connector")); 

//add the Paragraph to the card 
cardl . addParagraph (p) ; 

p = new Paragraph (Paragraph. AL I GN_LE FT, Paragraph .MODE_WRAP) ; 



//a link to the second card 
String href = "?#c2 M ; 
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//make a Go task with the href 

Go go = new Go (href , true , Go . METHOD_GET) ; 

//create the Anchor with the Go task 

Anchor anchor = new Anchor (go, new Text ( "Login" )) ; 

//add the anchor to the Paragraph 
p . addChild (anchor) ; 

//add the second Paragraph to the card 
cardl .addParagraph(p) ; 

//add the first card to the deck 
deck. addCard( cardl) ; 

// create a new MultiplelnputCard and give it the ID f c2' This allows the user to 

type in information 
MultiplelnputCard card2 = new MultiplelnputCard ( "c2 ") ; 

/ / hos t name input 

Labeledlnput host = new Labeledlnput { "host ", "Host :") ; 

// set the input text to lowecase by deafult 
_ host . setFormat ( " *m" ) ; 

□ // username input 

ji Labeledlnput userName = new Labeledlnput ( "usr" , "Username : " ) ; 

!f= userName . setFormat ( " *m" ) ; 

1= // pasword input 

sj Labeledlnput password = new Labeledlnput ( "pwd" ," Password :") ; 

\j password. setFormat ( " *m" ) ; 

7z //display input characters as stars... 

& password . setType ( Input . TYPE_PASSWORD) ; 



Labeledlnput [] inputs = {host, userName, password}; 

//set the URL params to the values in the WML variables & , the escape sequence 

for ampersand, delimits name- 
//value pairs. $ is used to dereference a WML variable. 

href = "?action=msgs&color=$ (color) &host=$ (host) &pwd=$ (pwd) &usr 
=$ (usr ) &amp ; rnd= " +Math . random ( ) ; 



//build the card with the href, "Submit" as the button label, the array of Inputs, 

and the method specified. 
card2 .buildCard(href , "Submit" , inputs, Go . METHOD_GET ) ; 

deck . addCard ( card2 ) ; 

String resultString = deck . render () ,- 
return resultString; 



* This method renders a deck with one card containing the message headers if any, else ^ 

an error message explaining no messages available. 

* 

* ©param msgs the messages to render. 

* ©return the rendered deck. 
*/ 

public String renderMessageHeaders (Storel terns msgs) 

{ 

//create the deck 
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WMLTagDocument deck = new WMLTagDocument ( ) ; 
if (msgs.sizeO == 0) 

// no messages available for display 

DisplayCard card = new DisplayCard ( "err 1 ", "ERROR" ) ; 

card.buildCard ("There are no messages in this f older " , Paragraph .AL I GN_CENTER) ; 
deck. addChild (card) ; 

} 

else 

// there are messages, go ahead and render them. . 
String url = null; 

int msgldx; 

String titleText = ( (Message) msgs . elementAt (0 ) ) .getLocationlnStore ( ) ; 
if (titleText == null) 
titleText = "INBOX" ; 

//create the first card in the deck and give it the ID •cl' 
DisplayCard card = new DisplayCard ( "cl ") ; 

Paragraph p = new Paragraph (Paragraph .AL I GN_LE FT, Pa rag raph . MODE_NOWRAP ) ; 

p. addChild (new Text (titleText)); 

p. addChild (new Break ()) ; 
]5? card.addParagraph (p) ; 

Paragraph p2 = new Paragraph (Paragraph . ALIGN_LEFT, Paragraph . MODE_NOWRAP) ; 

// add the message items 
;^ Message msg; 

'"--1 for (int i = 0; i < msgs. size (); i+ + ) 

ii { 

msg = (Message) msgs . elementAt (i) ; 
1 3 // display an image if the phone supports it 

|f] p2 .addChild (new Image(new I con (I con. ENVELOPE!) , Image . ALIGN_MIDDLE , null) ) ; 

5ff //get the subject text, shorten if necessary 

IP String subText - "no subject"; 

§3 if (msg.getSubject () != null && msg . getSubj ect (). length ( ) > 0) 

subText = msg .getSubject ( ) ,- 

if (subText .length () > HEADER_SUBJECT_LENGTH) 

subText = subText - substring ( 0 , HEADER_SUBJECT_LENGTH- 3 ) + "..."; 

subText = ReservedCharacter . reformat (subText); 

} 

p2 .addChild (new Text (subText) ) ; 



//get the from text, shorten if necessary 
String f romText = "no sender" ; 
if (msg .getFrom ( ) != null) 

fromText = msg . getFrom (). getDisplayName () ; 

if (fromText == null) 

{ 

fromText = msg .getFrom (). getAddress () ; 
if (fromText ! = null) 

^ if (fromText .length () > HEADER_FROM_LENGTH) 

fromText = fromText . substring (0, HEADER_FROM_LENGTH) ; 

} 

else 

fromText = "no sender" ; 

} 
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else if (fromText .length () > HEADER_FROM_LENGTH) 

fromText = fromText . substring (0, HEADER_FROM_LENGTH ) 

} 

p2 .addChild (new Text ( fromText ) ) 
p2 . addChild (new Break ( ) ) ; 

} 

p2 . addChild (new Break ( ) ) ; 
// link home. 

String href = " ?rnd= "+ Math . random () ; 

Go go = new Go (href , true , Go . METHOD_GET) ; 

Anchor anchor = new Anchor (go, new Text ("Start again...")); 

p2 .addChild (anchor) ; 

card . addParagraph ( p2 ) ; 
deck.addCard (card) ; 

} 

return deck . render () ,- 



* This is a simple exception rendering method. 
* 

* ©param message the message to be presented to the user 

* ©return the rendered WML deck 
*/ 

private String renderExcept ion (String message) 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard () ; 
Paragraph p = new Paragraph ( ) ; 

p. addChild (new Text (message) ) ; 
p. addChild (new Break () ) ; 

String href = " ?rnd= " +Math . random ( ) ; 

Go go = new Go (href , true , Go . METHOD_GET) ; 

Anchor anchor = new Anchor (go, new TextC'Start again...")) ; 

p . addChild (anchor) ; 

card . addParagraph (p) ; 
deck. addCard (card) ,- 

String resultString = deck . render () ; 
return resultString; 



} 



• 



• 



README . txt 



Customltem Sample Groupware Connector 



Wireless SDK for ThinAir server 



About this sample 



This sample Groupware connnector demonstrates how to write a simple connector 
using the ThinAir Groupware API that allows a user to log in to their 
groupware store, and retrieve an item with custom fields, or add a new item 
with custom fields, of the Providers shipped with the ThinAir Server, the 
Domino and Exchange Providers both support custom item handling. 

The Customltem Connector first has the user log into the groupware store, 
using login data entered in the connector.ini file. The Connector can easily 
be modified to prompt for this information, as the Getltems Groupware Connector 
does, if the login is accepted by the Groupware Provider, the connector prompts 
the user to choose one of two actions: either retrieving the first message in 
the user's specified folder, or adding a new item in the user's specified 
folder. 

The location of the custom items folder must be specified in the connector.ini 
file. For accessing an Exchange store, only the Folder value need be specified. 
*^o access a Domino store, both the Folder and the Database values must be 
Specified, since Domino uses a database/folder scheme to store data, to specify 
-U Domino database, use the file name (which ends with M .nsf") for the database, 
iXqot the Notes name. 

'#his example can easily be modified to retrieve several items at once, or to 
-perform other Groupware actions (such as moving, updating and deleting), see 
5 hche other Groupware samples for more information on how to interact with 
fijhinAir Groupware Providers. 

i; ilote: This sample connector is written for WML devices only. 



f\ * platform. jar 
3 * taglib.jar 
~ * groupware. jar 

This sample does not require any other external apis. 



Sample Files 

This sample consists of the following file tree: 
connector.ini - connector configuration file 
Customitemconnector. class - compiled Java code 
/src - java source files 



Building the Sample 

Compile the sample code using the Java compiler of your choice. The included 
make script will compile the sample using the JDK, if available. 

install the compiled sample code and connector.ini configuration file into a 



^equi rements 



i^his sample requires 



the following SDK jars: 
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subdirectory of the ThinAir server's /Connectors subdirectory, given a name 
of your choice. 

Start the ThinAir Server, it will load the sample code and begin executing it. 



using the sample 



wait until the Thi nAi rserver has started and the customitems Connector has been 
loaded and initialized. From a wml device, enter the IP address listed as the 
value for ApplicationPath in connector.ini (your ThinAi rserver IP address), 
followed by /samples/custom. For a machine with IP address 111.222.12.34 this 
would be: 

http : //111 . 222 . 12 . 34/sampl es/custom 
Follow the on-screen instructions. 



Last updated: 11.17.2000 
copyright 1999, 2000 ThinAirApps Inc. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE .TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//core ThinAir Server API functionality 
import com. thinairapps . platform . * ; 
import com. thinairapps . platform . device . * ; 
import com. thinairapps .platform. connector . * ; 
import com. thinairapps .platform. exception . * ,- 
import com. thinairapps .platform. provider . * ,- 

//rendering packages used to build markup 
import com . thinairapps . tag . *.; 
import com . thinairapps . tag . wml . * ; 

// the groupware packages 

import thinairapps . groupware . api . * ; 

import thinairapps . groupware . api .actions . * ,- 

import thinairapps . groupware . api . bounds . * ; 

import thinairapps .groupware . api . exception . * ; 

import java.util.*; 
import java.io.*; 

*igj**This sample illustrates the use of the Customltem type to handle data in custom-created 
if,* folders and databases. 

This sample renders WML. It prompts the user to choose one of two actions: add (create a * 

""~4 new 

item in the specified folder) , or read (get the field names and values in the first item * 
\\\ found 

within that folder, and display a group of them on the screen) . 

* 

§3* The login data (provider name, host name, username, password) , the name of the template/ \£ 
. form for 

• the custom item folder, the name of the folder and (for a Lotus Domino item) the name of 
^ the 

j7|* database, are all specified within the t connector . ini file. 
* 

]S* For a comprehensive reference of the Groupware Library see the ThinAir Groupware javadocs. 

92*/ 

s-public class CustomltemConnector implements Connector 

M 

// The friendly name of this sample app 
protected String appName; 

// Our access point to the services of ThinAir Server 
protected ConnectorAccess connectorAccess ; 

// The application log 

protected com . thinairapps . platform . connector .ApplicationLog log; 

// The provider 

protected String provider; 

// The user's login data 

protected String host, userName, password; 

// The location of the custom item folder within the Groupware store. 
// This should not be a global variable in a real connector, 
protected String location; 

// The name of the form/template that this custom folder uses - 

// this variable is not actually used in any of this connector's code; however, 
// it was included because it would be used by any real connector dealing with 
// Customltems, to add new items. See the comments within the addCustomltem ( ) 
// method for details 
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protected String f ormName ; 

protected String sessionld = null; 

private String ACTION_FIELD = "actions- 
private String L.OGIN_ACTION = "logins- 
private String CRE ATE_ACT I ON = "add"; 
private String READ_ACTION = "read" ; 



/ * * 

* initO is called by the ThinAirServer when the Connector is loaded. It provides the \£ 

connector with 

* resources it needs to interact with the ThinAirServer. 

* For more information about the Connector interface, see the javadocs for the ThinAir \i 

Server API 

* 

* ©param applicationName is a String derived from connector.ini. 

* ©param applicationPath is a String derived from connector.ini. We don't need this for/ 

this sample. 

* ©param connectorProps is a Properties list containing developer assigned * 

connector-specific properties. 

* ©param connector Access is our access point to the services provided by ThinAir Server. 

*/ 

J public void init (String applicationName, String applicationPath, Properties kT 
0 connectorProps, 

f% ConnectorAccess connectorAccess , com . thinairapps .platform, connector . *f 

ApplicationLog appLog) throws ConnectorlnitException 



{ 



this.appName = applicationName,- 

this . connectorAccess = connectorAccess; 

log = appLog; 

// the two strings from connector.ini that we'll use to create the official 
// "location" string 
String folder, database; 

// get provider name, as well as all login data, location of the custom folder, and 
// the name of the form/template being used, from the properties list (connector.ini) 
// Make sure you set up all necessary information before running this example, 
provider = connectorProps . get Property (" Provider ") ; 

if (provider . length ( ) == 0) throw new ConnectorlnitException ( "No Provider entry in uf 
connector.ini") ; 

host = connectorProps .getProperty ( "Host" ) ; 

if (host . length ( ) == 0) throw new ConnectorlnitException ( "No Host entry in connector./ 
ini") ,- 

userName = connectorProps .getProperty ( "UserName" ) ; 

if (userName . length ( ) =- 0) throw new ConnectorlnitException ( "No UserName entry in kf 
connector . ini " ) ; 

password = connectorProps . getProperty (" Password" ) ; 

if (password. length () 0) throw new ConnectorlnitException ( "No Password entry in *r 

connector . ini " ) ; 

folder = connectorProps . getProperty ( " Folder" ) ; 

if (folder .length () == 0) throw new ConnectorlnitException ( "No Folder entry in 
connector . ini " ) ; 

database = connectorProps .getProperty ( "Database ") ; 

//no exception thrown if user didn't include the name of the database - this may or 
may 

// not be a necessity for the groupware store being accessed. In the case of the / 
group ware 

// providers that come with the ThinAir Server, the Domino provider requires one, ^ 
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while the 
// Exchange provider doesn't 

// now, set the location string - if no database name was included, then location 
// will just be equal to the folder name 
if (database. length () == 0) 

{ 

location = folder; 

} 

else 

{ 

// a database name was included; since we have only a single String to represent 
// the location within the eventual data request, how do we get both the folder 
// and the database name into this one String? Thankfully, there's a utility in 
// the Customltem class that takes care of it for us 

location = Customltem . LocNameUtils . createLocationString (database , folder); 

} 

formName = connec tor Props .get Property ( "FormName" ) ; 

// no exception thrown if user didn't include the name of the folder's f orm/ template ; 
// a Customltem connector can function without it, although not as well 



■ s n /**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 
"""4 the names of all 

3 p * DeviceProf iles supported by this Connector. These names are the friendly names used wr 
\\l to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer y? 
"2; to the ThinAir 

jjy * server Developer Guide or call DeviceProf ile ' s getNameO method. 
. * 

]^ * For more details about device detection and handling see the DeviceDetective sample ^ 
™ connector and the 

l-Js * ThinAir Server Developer Guide. 
* 

i» * ©return an array of Strings representing the friendly names of the devices this \l 
Connector supports . 

O */ 

lek public String [] getDevicesO 

{ 

String deviceType = " TA_WAP " ; 
String [] deviceTypes = {deviceType}; 
return deviceTypes; 

} 



/**The handle method implements the core logic of a Connector. It takes an incoming 
request from a 

* particular device, and returns an appropriate response. This method is called whenever^ 

the server 

* receives a request from a type of device that the Connector indicates it supports, 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of 

the Connector 

* to interpret the request and generate an appropriate response. 
* 

* The server will pass a Device object containing as much information as possible into * 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed ^ 

information 

* on the capabilities of the particular device making the request. 
★ 

* ©param props a set of name value pairs corresponding to the HTTP request parameters ^ 
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from the device. 

* ©param device a Device object created in the image of the actual device making this 

request . 

* ©param result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle (Properties props, Device device, OutputStream result) throws * 
IOException 

{ 

String resultString = null; 

//get the 'action' parameter from the request. This is an HTTP param we define to * 

determine what action 
//to take when we get a request. 

String action = props .get Property (ACTION_FI ELD) ; 

try 
{ 

if (action == null) 

// if this is the first hit (or any request for the main deck) , build a 
// deck that lets the user specify which action to run 
resultString = renderStartScreen ( ) ; 

} 

else if ( act ion. equal s (LOGIN_ACTION) ) 
{ 

sessionld = loginUser (provider , host, userName, password) ; 
resultString = renderOptionMenu ( ) ; 

} 

else 
{ 

if { act ion. equal s(CREATE_ACTION) ) 
{ 

addCu st omit em (location, sessionld) ; 

resultString = renderMessage ( " Item successfully added!"); 

} 

else if (action. equals (READ_ACTION) ) 
{ 

Customltem item = getCustomltem ( location, sessionld) ; 

//render the fields of this object 
resultString = renderCustomltemFields ( item) ; 

} 

// log off the user 

connectorAccess .getStoreProvider (sessionld) . disconnectUser ( ) ; 
// then delete the session 
connectorAccess . deleteSession (sessionld) ; 



} 
} 

catch (Exception e) 

{ 

e . printStackTrace ( ) ; 

// Here, we employ a primitive solution of simply displaying the error message * 
and providing a link 

// back to the welcome screen; a larger app would handle each error separately * 

and navigate the 
// user accordingly 

resultString = renderMessage (e .getMessage ()) ; 

} 

// in this example we logged on, performed a simple action, then logged off again. A 
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more 

// complete app would hold the session open between requests, and cache the retrieved 
// Storeltems in the session cache, using this to feed item bodies out to the client 
// without going to the provider each time 

byte[] resultBytes = resultString .getBytes ( ) ; 
result .write (resultBytes) ; 

} 

/**loginUser ( ) logs in the user to a groupware store using the specified login data 
* 

* Oparam providerName the name of the provider being used to access the message store. 

* Oparam host the IP or server name of the message store. 

* ©param userName the user name of the account being logged onto. 

* ©param password the password for this user. 

* ©return a providerSessionld if success; otherwise an error will be thrown. 
*/ 

protected String loginUser (String providerName, String host. String userName, 

String password) throws Exception 

{ 

String SID = null; 

try 
{ 

// Create a new Session with the specified provider and returns a unique Session «r 
ID. 

SID = connectorAccess . createProviderSession (providerName) ,- 

// Get the providerProxy associated with the session we just created, 
// this is what is used to interact with the Provider 

StoreProviderProxy spLite = connectorAccess . getStoreProvider (SID); 

// Create a StoreProviderLogin object, this defines the action the provider will 
execute 

StoreProviderLogin login = new StoreProviderLogin (userName, password, host) ; 

// use the providerProxy to login. The provider returns the items it supports 
Supportedltems supports = spLite . connectUser (login); 

// check to make sure that this provider handles Customltem objects 

boolean support sCust I terns = false,- 

Enumeration supportedEnum = supports . get I terns () ; 

while ( supportedEnum. ha sMoreEl ements () ) { 

Supportedltem curltem = ( Support edit em) supportedEnum. nextElement () ; 

if (curltem. getType ( ) == ItemTypes . CUSTOM_ITEM) 
supportsCustltems = true; 

} 

// if it doesn't handle Customltem objects, throw an exception 
if (! supportsCustltems) 

throw new Exception ( "Specif ied provider ( " + providerName + " ) does not 
support Customltem handling"); 

} 

catch (NoSuchProviderException e) 

throw new Except ion ( "No Provider named " + providerName + " was loaded by the ^ 
ThinAir Server"); 

} 

return SID; 



/**getCustomItem( ) retrieves the first item from a groupware location, and returns a 
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* Customltem object containing all its information 
* 

* ©param location The location in the groupware store being accessed 

* ©param SID The session ID for the user's connection to the groupware store 

* ©return a Customltem representing the first item in the folder 
*/ 

protected Customltem getCustomltem (String location, String SID) throws Exception 
{ 

String resultString ; 

ItemRequest iReq = new ItemRequest (); 

iReq. itemType = ItemTypes . CUSTOM_ITEM; 

iReq . itemLocat ion = location,- 

iReq.max = 1 ,- 

iReq. start ID = null; 

iReq. bounds = null; 

UserDataRequest udReq = new UserDataRequest (); 
udReq. requests = new ItemRequest [1] ; 
udReq. requests [0] = iReq; 

UserData uData = connectorAccess .getStoreProvider (SID) .getUserData (udReq) ; 
ItemRequest Response irr = uData . responses [0] ; 
Storeltems customl terns = irr. items; 

//we got back customltems; get the first element out (which is all 
// we requested) 

return (Customltem) customltems . elementAt { 0 ) ; 



/**addCustomItem( ) adds an item to a groupware location containing custom- 

* definted items 
* 

* ©param location The location in the groupware store being accessed 

* ©param SID The session ID for the user's connection to the groupware store 

*/ 

protected void addCustomltem (String location, String SID) throws Exception 

^ //In order to add a new item and populate its fields, we have to know 
// what the names of its fields are. If this were a real application, 
// we'd already know ahead of time what all the fields are named, and could 
// thus prompt the user for the values of those fields we wanted to populate. 
// The code would look something like: 

// Customltem custltem = new Customltem (formName) ; 
// custltem. addField(importantFieldl, importantFieldlUserValue) ; 
// custltem. addField( importantField2 , importantField2UserValue) ; 
// ...etc. 

// However, because this is a generic sample, we don't know what any 
//of the fields will be ahead of time. The following code, thus, is a 
// hack: we create a Customltem object that has the properties of the 
// first item in this folder, using the getCustomltem ( ) method. This 
// object now has all the fields that the items in the folder being 
// accessed contain (or at least all but the standard item fields - 
// see the discussion below) . We then go through each of the fields and 
// set them to a new value, depending on their type. We then create 
// the item. 

Customltem custltem = getCustomltem (location, SID) ; 

// let's loop through the fields in this new item and set some values 
// get an enumeration of all the custom fields 

Enumeration fieldEnum = custl tem.getCustomFieldData ( ) . getFields ( ) ; 



while (f ieldEnum.hasMoreElements ( ) ) 

{ 
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//get the next field 

Field thisField = ( Field) fieldEnum . nextElement () ; 
if (thisField. getName () .lengthO > 0) { 

String fieldName - thisField. getName () ; 

//check the type 

if ( thisField. getType () =» Field . BOOLE AN_VAL) 

//set all booleans to true 
thisField . set (true) ; 

lse if (thisField.getTypeO == Field . DOUBLE__VAL) 

//set all doubles to be 123.123 
thisField. set (123 .123) ; 

lse if (thisField.getTypeO == Field . INT_VAL) 

//set all ints to 123 
thisField. set (123) ; 

lse if (thisField.getTypeO == Field. LONG_VAL) 

//set all longs (this will include currency values) to 123.45 
thisField. set (123 . 45) ; 

lse if (thisField.getTypeO Field . STRING_VAL) 

thisField. set ( "New String!"); //set all strings to "New String! 1 

lse if (thisField.getTypeO == Field . DATE_VAL) 

//set all dates to current time 

thisField. set (new Date (System. currentTimeMillis () ) ) ; 



// That took care of all the custom fields. It may not have, however, taken care 
// of all the standard item fields, those fields that were present in the groupware 
// store template that this folder's form/template was derived from (if, in fact, it 
// was derived from another template) . If we wanted to access these standard fields, 
// we would do: 

// Storeltem standardltem = item. getStandardl tern () ,- 

// Then you could treat standardltem like any other groupware Storeltem; 

// see the other groupware connector samples for more on how to manipulate standard * 
items 

// set the location of the new item to be the user-specified location 
custltem. setLocationlnStore (location) ; 

StoreProviderProxy spProxy = connectorAccess . getStoreProvider (SID); 

AddNewGroupwareltem addAction = new AddNewGroupwarel tern (custltem) ; 

spProxy . doUserDataAc t ion (addAction) ; 
return; 

} 



/**This method renders a deck containing a welcome card 
* 
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* ©return the rendered deck . 
*/ 

private String renderStartScreen { ) 

{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//create a card in the deck and give it the ID • cl' 
DisplayCard cardl = new DisplayCard ( "cl ") ; 

//create a centered Paragraph 

Paragraph p = new Paragraph (Paragraph .AL I GN_CENTER, Paragraph . MODE_WRAP) ; 

p.addChild(new Text ( "Custom Items")); 
p . addChild (new Break ( ) ) ; 

p . addChild (new Text("Sample Connector") ) ; 

//add the Paragraph to the card 
cardl . addParagraph (p) ; 

p = new Paragraph { Paragraph - ALIGN_LEFT , Paragraph . MODE_WRAP) ; 
// links to the two possible actions 

String loginHref = "?" + ACT I ON_F I E LD + " = " + LOGIN_ACTION + Tt &rnd=" + Math. 
random ( ) ; 

// Go task for the href 

Go loginGo = new Go ( loginHref , true , Go .METHOD_GET) ; 
// Anchor for the Go task 

Anchor loginAnchor = new Anchor (loginGo, new Text ( "Login" )) ; 

//add the anchors to the Paragraph 
p. addChild (loginAnchor) ; 

//add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//add the card to the deck 
deck. addCard (cardl) ; 

String resultString = deck . render () ; 
return resultString; 



/**This method renders a deck with a card that lets the user specify which action to take 
* 

* ©return the rendered deck. 
*/ 

private String renderOpt ionMenu ( ) 

{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//create a card in the deck and give it the ID 'cl' 
DisplayCard cardl = new DisplayCard ( "cl " ) ; 
//create a centered Paragraph 

Paragraph p = new Paragraph ( Paragraph .AL I GN_CENTER, Paragraph . MODE_WRAP) ; 

p. addChild (new Text ("Custom Items")); 
p. addChild (new Break () ) ; 

p . addChild (new Text ("Sample Connector")); 

//add the Paragraph to the card 
cardl . addParagraph (p) ; 

p = new Paragraph (Paragraph. AL I GN_LE FT, Paragraph. MODE_WRAP) ; 
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// links to the two possible actions 

String createHref = "?" + ACT I ON_F I ELD + "=" + CREATE_ACTION + " &amp ; rnd= " + Math. * 
random ( ) ; 

String readHref = "?" + ACTION_FIELD + " = " + RE AD_ACT I ON + " &amp ; rnd= M + Math. random * 
0 ; 

// Go tasks for the two hrefs 

Go createGo = new Go (createHref , true , Go .METHODJ3ET) ; 
Go readGo = new Go ( readHref , true , Go . METHOD_GET) ; 

// Anchors for the two Go tasks 

Anchor createAnchor = new Anchor (createGo, new Text ( "Create a new item")); 
Anchor readAnchor = new Anchor ( readGo , new Text ("Read first item")) ; 

//add the anchors to the Paragraph 
p. addChi Id (createAnchor) ; 
p. addChi Id (readAnchor) ; 

//add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//add the card to the deck 
deck. addCard( cardl) ; 

String resultString = deck . render () ; 
return resultString; 



;M /**This method renders a deck with one card containing the first 15 fields in 
Si * the Customltem. 
■{% * 

* ©param item the Customltem whose fields we should render 
„ * ©return the rendered deck. 

i */ 

11 public String renderCustomltemFields (Customltem item) 
^ { 

!f //create the deck 

~fl WMLTagDocument deck = new WMLTagDocument ( ) ; 

3 String url = null; 

~ , //create the first card in the deck and give it the ID 'cl' 

DisplayCard card = new DisplayCard ( "cl " ) ; 

Paragraph p = new Paragraph (Paragraph . ALIGN_LEFT, Paragraph . MODE_NOWRAP ) ; 

p.addChild(new Text ("Custom Item")); 

p. addChi Id (new Break ()) ; 
card. addParagraph (p) ; 

Paragraph p2 = new Paragraph ( Paragraph . ALIGN_LEFT , Paragraph . MODE_NOWRAP ) ; 
// Now add the fields and their values 

//first get the Data object that conatins all the info about our custom fields. 
Data customFields = item . getCustomFieldData ( ) ; 

//we can get an enumeration of the fields. . . 
Enumeration fieldEnum = customFields . getFields () ; 

// go through the fields, and add each one to the deck - we'll stop after 15, 
// to avoid any deck overflow problems 
int itemsDisplayed = 0 ,- 

while (f ieldEnum.hasMoreElements ( ) && itemsDisplayed < 15) 
{ 
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String fieldText = null; 

Field thisField = (Field) fieldEnum. nextElement () ; 
//you must check the type 

if (thisField. getType {) == Field . B00LEAN_VAL) 



} 



fieldText = thisField . getName ()+ " 
else if (thisField. getType ( ) == Field 
fieldText = thisField . getName ()+ " 
else if (thisField. getType ( ) == Field 
fieldText = thisField . getName ()+ " 
else if (thisField. getType ( ) == Field 
fieldText - thisField . getName ()+ " 
else if (thisField. getType ( ) == Field 
fieldText = thisField . getName ()+ " 
lse if (thisField. getType ( ) == Field 
fieldText = thisField .getName {)+ " 



p2 .addChild(new Text (fieldText ) ) ; 
p2 .addChild (new Break ( ) ) ; 
itemsDisplayed++ ; 



" + thisField. getBoolean {) , 
DOUBLE_VAL) 

" + thisField. getDouble () ,- 
INT_VAL) 

" + thisField. getlnt () ; 
L0NG_VAL) 

" + thisField. getLong () ; 
STRING_VAL) 

" +• thisField. getString () ; 
DATE_VAL) 

" + thisField. getDate () ; 



// link home. 

String href = " ?rnd= "+Math . random () ; 

Go go = new Go (href , true , Go . METHOD_GET) ; 

Anchor anchor = new Anchor (go, new Text ("Start again. 

p2 .addChild (anchor) ; 

card.addParagraph (p2 ) ; 
deck.addCard (card) ; 



') ) ; 



return deck . render ( ) ; 



/** This method renders a simple message, either an error or a success, 

* then links back to the main page 

* ©param message the message to be presented to the user 

* ©return the rendered WML deck 

*/ 

private String renderMessage (String message) 
{ 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( ) ; 
Paragraph p = new Paragraph ( ) ; 

p. addChild (new Text (message) ) ; 
p . addChild (new Break ()) ; 



String href = " ?rnd= "+Math . random () ; 

Go go = new Go (href , true , Go . METHOD_GET) ; 

Anchor anchor = new Anchor (go, new Text( M Start again... ")); 
p. addChild (anchor) ; 
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card . addParagraph ( p ) ; 
deck .addCard (card) ; 

String resultString = deck . render () ; 
return resultString; 




README.tXt 



WML Rendering sample Connector 
wireless SDK for ThinAir server 



About this sample 

This sample Connector demonstrates the use of the wml Tag library to accept 
input from wml forms and render output for wml Browsers. 



Requi rements 

This sample requires the following SDK JARs: 

* platform. jar 

* tag! ib. jar 

This sample does not require any other external apis. 



connector.ini - connector configuration file. 

WMLSamplesConnector. class - compiled Java code 

/src - the Java source file, WMLSampl econnector . java 



"^Building the sample 



= Mompile the sample code using the Java compiler of your choice. Make sure to 
^append the required jar files above into your CLASSPATH. 

! ^install the compiled sample code and connector.ini configuration file into a 
" subdirectory of the ThinAir Server's /Connectors subdirectory, given a name 
of your choice. 

Start the ThinAir server, it will load the sample code and begin executing it. 



using the Sample 



wait until the ThinAi rserver has started and the wml Rendering connector has 
been loaded and initialized. From your wml device, enter the IP address listed 
as the value for Applicationpath in connector.ini (your Thi nAi rserver IP 
address), followed by /sampl es/wml . For a machine with IP address 
111.222.12.34 this would be: 

http : //111 . 222 . 12 . 34/sampl es/wml 

Follow the on-screen instructions. 



Sample Files 

5Tj 



This sample consists of the following file tree: 



Last updated: 11.13.2000 
Copyright 1999, 2000 ThinAirApps inc. 



Page 1 




page 2 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC - AND LICENSEE ♦ ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com. thinairapps -platform. connector . * ; 
import com. thinairapps . platform. device . * ; 

//Rendering packages used to build markup 
import com. thinairapps . tag .* ; 
import com . thinairapps . tag . wml . * ; 

//Core Java API 
import java.util.*; 
import j ava . io . * ; 



/ ** 

* This is a simple sample whose purpose is to illustrate the use of the ThinAir WML Tag 

* Library. It creates two simple WML decks: the first prompts the user for their favorite / 

color, 

__* username and password, the second simply echos the submitted values. This sample makes 
3* use of SelectlnputCard, Multiple Input Card, DisplayCard, Do, Go, Anchor, Paragraph, Text, 
0 and Break. 
^* 

:id > For more information on use of the WML Tag Libraries, see the Tag Library documentation 

y and the ThinAir 

£* Server Development Guide . 

public class WMLSampleConnector implements Connector 

*=? //Declare variables global to this Connector 

String appName ; 

s=l ConnectorAccess access; 
f: String appPath; 



/** 

* initO is called by the ThinAirServer when the Connector is loaded. It provides the \£ 

Connector with 

* resources it needs to interact with the ThinAirServer. 
* 

* Oparam applicationName is a String derived from connector.ini. We don't need this for/ 

this sample . 

* ©param applicationPath is a String dervid from connector.ini. We don't need this for / 

this sample. 

* ©param connectorProps is a Properties list containing developer assigned 

connector- specif ic properties. 

* We don't need this parameter in this sample. 

* ©param connectorAccess is our access point to the services provided by ThinAir Server 

We don't need this for this sample. 

* ©param applicationLog is used for Logging. We do not use this in this sample 
*/ 

public void init (String applicationName, String applicationPath, Properties 

connectorProps, ConnectorAccess connectorAccess, ApplicationLog applicationLog) 

{ 

appName = applicationName ,- 
access = connectorAccess; 
appPath = applicationPath; 



/ * * 

* getDevicesO is called once by the ThinAir Server during start-up. It allows a / 
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Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing \i 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used \£ 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer * 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getName ( ) method. 
* 

* For more details about device detection and handling see the DeviceDetective sample ^ 

connector and the 

* ThinAir Server Developer Guide. 
* 

* ©return an array of Strings representing the friendly names of the devices this * 

Connector supports. 

*/ 

public String [] getDevicesO 

{ 

String deviceType = "TA WAP"; 
String [] deviceTypes = JdeviceType } ; 
return deviceTypes; 

} 



Zj. J * * 

S * The handle method implements the core logic of a Connector. It takes an incoming 
p request from a 

^ * particular device, and returns an appropriate response. This method is called whenever 
H the server 

E * receives a request from a type of device that the Connector indicates it supports, 
\% destined (as 

^ * indicated in the request URL) for a specific application. It is the responsibility of * 
^ the Connector 

D * to interpret the request and generate an appropriate response. 
* 

ss. * The server will pass a Device object containing as much information as possible into 
^ this method. 

p * The Connector can then utilize the particular Device class to determine more detailed 
^ information 

Z. * on the capabilities of the particular device making the request. 

i - * 

3 * ©param props a set of name value pairs corresponding to the HTTP request parameters \l 
„l from the device. 

* ©param device a Device object created in the image of the actual device making this \£ 

request . 

* ©param result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle (Properties props, Device device, OutputStream result) 

{ 

String resultString = null; 

//Get the 'action' parameter from the request. 

//This is an HTTP param we define to determine what action to take when we get a * 
request . 

String action = props .getProperty ("action") ; 

//If this is the first hit 
if (action == null) 

{ 

//Build a deck that lets the user enter information. 
resultString = renderWelcome ( ) ; 

} 

//If they have already entered the information, then display it 

else if (act ion . equals ( "display" ) ) 

{ 

//Build a display deck with the entered info, pass the request properties in 
resultString = renderAnswers (props) ; 

} 
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byte[] resultBytes = resultString . getBytes ( ) ; 

try 

{ 

result .write (resultBytes) ;• 

} 

catch (IOException e) 

System. err .println { "Error ! Unable to write to result OutputStream . " ) ; 

} 

} 



I * * 

* This method renders a deck with several cards including a welcome card and card for * 

entering information 

* 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For * 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server * 

Development Guide . 

* 

* ©return the rendered deck. 
*/ 

private String renderWelcome ( ) 

{ 

//Create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create the first card in the deck and give it the ID 'cl 1 
DisplayCard cardl = new DisplayCard ( "cl " ) ; 

//Create a centered Paragraph 

Paragraph p = new Paragraph ( Paragraph . ALIGN__CENTER , Paragraph . MODE_WRAP ) ; 

p.addChild(new Text ( "Render WML " ) ) ; 
p.addChild(new Break () ) ; 
p. addChild (new Text ( "Welcome" ) ) ; 
p . addChild (new Break ( ) ) ; 

//Add the Paragraph to the card 
cardl . addParagraph (p) ; 

p = new Paragraph ( Paragraph . AL I GN_L EFT , Paragraph . MODE_WRAP ) ; 

//A link to the second card 
String href = appPath + "?#c2"; 

//The go element is a task element that instructs the device to open a specified URL. 
Go go = new Go (href , true , Go . METHOD_GET) ; 

//The anchor element anchors a task to a string of formatted text. This is often * 

called a link. 
Anchor anchor = new Anchor (go, new Text ("Next") ) ; 

//Add the anchor to the Paragraph 
p . addChild (anchor) ; 

//Add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//Add the first card to the deck 
deck . addCard (cardl) ; 

//Create a second card, give it the ID * c2 ' 
SelectlnputCard card2 = new Select InputCard ( "c2 " ) ; 

//SelectlnputCards gives the user a choice list 
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//Create all the choices and make "OK" the button label for all of these 

//A single letter (i.e. 'r', ' o', 'y' etc) will be the value assigned to 

//the variable in order to keep the size of the transmission down 

Option red = new Option ( "OK" , "r" , "Red" ) ; 

Option orange = new Option ( "OK" , "o" , "Orange" ) ; 

Option yellow = new Option ( "OK" , "y" , "Yelow" ) ; 

Option green = new Option ( "OK" , "g" , "Green" ) ; 

Option blue = new Option ("OK" , "b", "Blue") ; 

Option indigo = new Option ( "OK" , "i" , "Indigo" ) ; 

Option plaid = new Option ( "OK" , »p" , "Plaid" ) ; 

//Make an array of all the options 

OptionU options = {red, orange, yellow, green, blue, indigo, plaid}; 

//Build the card. Link it to card 3 (c3) , set the prompt to be "Favorite color;", 
set 

//the variable name for this choice to be "color", then set the allignment and 
wrapping 

card2 .buildCard( "#c3 " , "Favorite color: " , "color" , options, Paragraph. AL I GN_LE FT, 
Paragraph. MODE_NOWRAP) ; 

//Add the SelectlnputCard 
deck. addCard (card2 ) ; 

//Create a new MultiplelnputCard and give it the ID 1 c3 ' 
3 MultiplelnputCard card3 = new MultiplelnputCard ( "c3 ") ; 

J //This allows the user to type in information 

Labeledlnput userName = new Labeledlnput ( "usr " , "Username : " ) ; 

£ //This sets the input text to lowecase by default though the user can change it 

\ § userName . set Format ( " *m" ) ; 

H Labeledlnput password = new Labeledlnput ( "pwd" , "Password :") ; 

0 password, set Format ( " *m" ) ; 

- //This will display input characters as stars 

^ password. setType (Input . TYPE_PAS SWORD) ; 

=j Labeledlnput [] inputs = {userName , password} ; 

1} //Set the URL params to the values in the WML variables 

3 //&, the escape sequence for ampersand, delimits name- 

_l //value pairs. $ is used to dereference a WML variable. 

href = appPath + "? act ion=display& color =$color& usr =$usr&pwd= $pwd& rnd 
= " +Math . random ( ) ; 

//Build the card with the href, "Submit" as the button label, the array of Inputs, * 

and the method specified. 
card3 . buildCard (href , "Submit" , inputs, Go . METHOD_GET ) ; 
deck.addCard (card3 ) ; 

//Render the deck 
return deck . render ( ) ; 

} 



private String renderAnswers ( Properties props) 

{ 

//Get the arguments passed from the welcome deck 
String usrName = props . getProperty ( "usr" ) ; 
String password = props . getProperty ( "pwd" ) ; 

//This will be a single letter, so we have to map it to a color 
String color = props .getProperty ( "color ") ; 
if (color « null) 

return renderExcept ion ( "Error ! No color was entered. "),- 
if (color . equals ( "r" ) ) 
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color - "Red" ; 
else if (color .equals ( "o" ) ) 

color - "Orange"; 
else if (color . equals ( "y" ) ) 

color = "Yellow" ; 
else if (color . equals { "g" ) ) 

color = "Green" ; 
else if (color .equals ( "b" ) ) 

color = "Blue"; 
else if (color . equals ( "i" } ) 

color = "Indigo" ,- 
else if (color . equals ( "p" ) ) 

color = "Plaid"; 

//Create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create the first card in the deck and give it the ID f cl f 
DisplayCard cardl = new DisplayCard ( "cl " ) ; 

//Create a centered Paragraph 

Paragraph p = new Paragraph (Paragraph .ALIGN_LEFT, Paragraph .MODE_WRAP) ,- 

//Display the values 
_ p.addChild (new Text (color) ) ; 

0 p . addChild (new BreakO); 

bp p .addChild (new Text (usrName) ) ; 

;U p .addChild (new BreakO); 

rtz 4 //Show the password for this sample. In general, of course, this is not recommended 

l\l p.addChild (new Text (password) ) ; 

cardl . addParagraph (p) ; 

//We add a random number to prevent unwanted caching by some browsers 
]^ String href = appPath + " ?rnd^ "+Math . random ( ) ; 

01 //The go element is a task element that instructs the device to open a specified URL. 
|3 //We pass an href with no action, this will bring us to the welcome page 

iJL Go go = new Go (href , true) ; 

O //This will make a button with the label 'Main* 

Do dew = new Do (Do . TYPE_ACCEPT, go, "Main" , "main" , false) ,- 

//Add the button to the card 
cardl . addChild (dew) ; 

//Add the card to the deck 
deck. addCard( cardl) ; 

//Render the deck 
return deck . render () ; 

} 



j * * 

* This is a simple exception rendering method. 
* 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For *t 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server ^ 

Development Guide. 

* 

* ©param message the message to be presented to the user 

* ©return the rendered WML deck 
*/ 

private String renderException (String message) 
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//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create a display card 

DisplayCard card = new DisplayCard () ,- 

//Create a new paragraph 
Paragraph p = new Paragraph*); 

p. addChild (new Text (message) ) ; 
p.addChild(new Break () ) ; 

//Create the URL 

String href = appPath + " ?rnd="+Math. random( ) ; 

//The go element is a task element that instructs the device to open a specified URL. 
Go go = new Go (href , true , Go . METHOD_GET) ; 

//The anchor element anchors a task to a string of formatted text. This is often X 
called a link. 

Anchor anchor = new Anchor (go, new TextC'Start again...")); 

//Add the anchor to the paragraph 
p .addChild (anchor) ; 



//Add the paragraph to the card 
card.addParagraph (p) ; 



//Add the card to the deck 
deck. addCard (card) ; 



//Render the deck 
return deck . render ( ) ,- 



:1 




README.tXt 

Profile Management Sample Connector 
wireless SDK for ThinAir Server 



About this Sample 

This sample connector demonstrates how to take advantage of ThinAir server's 
profile Management features, in the ThinAir Server architecture, user Profiles 
are server-wide, password-protected records that are available to all 
Connectors. A connector can store application-specific data within the User 
profile, and query the profile for data such as the user's known Devices. 

in this simple example the connector prompts the user for a number and stores 
it in their user Profile as application data. The connector then displays this 
information to the user. 

This Connector also makes use of session objects. For more information on 

using ...... , . 

sessions, see the sessionManagement sample connector in this directory and the 
corresponding ThinAir server API documentation. 

N.B. This sample connector is written for wml devices only. 



^Bequi rements 



„ijhis sample requires the following SDK DARs: 
W * platform. jar 

2 * tag! ib. jar 

lis 

this sample does not require any other external apis. 



Sample Files 



ijthis sample consists of the following file tree: 
laaJ connector.ini - connector configuration file 
5 ~ profi leconnector. jar - compiled Java code 

/src - java source files - Profi leconnector. java and Profi leData.java 



Building the Sample 



Compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your classpath. 

install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir server \s /Connectors subdirectory, given a name 
of your choice. 

start the ThinAir server, it will load the sample code and begin executing it. 



using the Sample 



wait until the Thi nAi rserver has started and the Profile Management Connector 
has been loaded and initialized. From your WML device, enter the IP address 
listed as the value for Appli cationPath in connector.ini (your Thi nAi rserver 
IP address), followed by /samples/profile. For a machine with IP address 



page 1 



README . tXt 

111.222.12.34 this would be: 

http : //111 . 222 . 12 . 34/sampl es/prof i 1 e 
Follow the on-screen instructions. 



Last updated: 11.13.2000 
Copyright 1999, 2000 ThinAirApps inc. 



=0 

m 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//This is a simple class which is the container for user profile data 
import java. io . Serializable ; 



public class ProfileData implements Serializable 

{ 

public String f avoriteNumber ; 

} 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE . ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com. thinairapps . platform . connector . * ,- 
import com- thinairapps . platform . device . * ; 
import com. thinairapps -platform -exception. * ; 

//Rendering packages used to build markup 
import com . thinairapps . tag . * ; 
import com. thinairapps . tag . wml . * ; 

//Core Java API 
import java.util.*; 
import j ava . io . * ; 



/**This example illustrates how to user ThinAir Server's Profile management features. 

* Because Profiles are usually most effective and useful in statef ul^applicat ions , 

* this example also makes use of sessions as well. For more information on using 

* sessions, see the SessionConnector sample, the ThinAir Server API documentation, 
13* and the ThinAir Server Development Guide. 

The ThinAir Server creates a password-protected User Profile for each user of the 
m* system so the user must first log in. This User Profile is identified by a globally 
"y* unique ID (the ThinAir User ID) . User Profiles include information about which 
= P* devices a user owns, which applications have been accessed by users and any application 
iff* specific data (such as the back-end server account information) . ThinAir Server 
administrators have control over all User Profiles through the User Manager tool 
that allows them to view all Profiles and add or remove users from both individual 
ID* applications and the ThinAir Server itself. 
* 

The Profile Connector follows a standard design pattern for ThinAir Connectors that 
==J* require user profiles. Once users log in, they are then shown a menu with various 
in* application features presented as options. In this simple example, users can set a 

favorite number and store it in their profile. In subsequent screens, they can then 
]~* view it. Returning users are handled in one of two ways depending on whether they have 

a device GUID. If the user has a device GUID, then the application looks up their User 
O* Profile based on that GUID and they don't have to log in each time that they access the 

application. Returning users without a device GUID are forced to enter in their User ID 

* (which corresponds directly to their UserProf ilelD internally) in order for the 

application 

* to recognize them (i.e. in order for them to have access to their User Profile) . 
*/ 

public class Prof ileConnector implements Connector 
{ 

//Declare variables global to this Connector 
String appName ,- 

ConnectorAccess access; 
String appPath; 

//We'll use this as the param name for user profiles 

public final static String US ER_PROF I LE_I D_ARG = "userProf ilelD" ; 

//This will be the param name for passwords 

public final static String USER__PROFILE_PWD_ARG ^ M pw" ; 

//The param name for the favorite number 

public final static String FAVORI TE_NUMBER = "num" ; 



/**init() is called by the ThinAirServer when the Connector is loaded- It provides the , ( 
* Connector with resources it needs to interact with the ThinAirServer. 



# 
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* ©param appl icat ionName indicates the friendly name of this Connector application. 

* It is a String derived from connector.ini and this sample does 

* utilize it. 

* ©param applicationPath is the path to this Connector application. 

* It is a String derived from connector.ini and this sample does 

* utilize it. 

* ©param connectorProps is a Properties object containing developer assigned, 

connector- specific 

* properties. It is derived from connector.ini and this sample 
does not 

* utilize it. 

* ©param connectorAccess is the one-and-only interface a Connector obtains to gain \i 

access to 

* the runtime services (such as session and user profile * 
management) 

* offered by the ThinAir Server to running Connectors. This 
sample uses 

* it to create a profile and store and retrieve data from the 
session cache. 

* 

* ©param appLog is used for Logging 
*/ 

public void init (String appl icat ionName , String applicationPath, Properties 

connectorProps, ConnectorAccess connectorAccess, com. thinairapps .platform. connector . * 
Appl icat ionLog appLog) 



appName = appl icat ionName ; 
access = connectorAccess; 
appPath = applicationPath; 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a * 
Connector to 

* indicate the types of devices it supports. getDevices ( ) returns an array containing \i 

the 

* names of all DeviceProf iles supported by this Connector. These names are the friendly 

names 

* used* to uniquely identify every DeviceProf ile . To get the friendly name of a * 

particular device, 

* refer to the ThinAir Server Developer Guide or call DeviceProf ile ' s getName ( ) method. 
★ 

* For more details about device detection and handling see the DeviceDetect ive sample \l 

Connector and the 

* ThinAir Server Developer Guide. 
* 

* ©return an array of Strings representing the friendly names of the devices this 

Connector supports . 

*/ 

public String [] getDevices () 
{ 

String deviceType = "TA WAP" ; 
String [] deviceTypes = X^ ev: i- ceT YP e } ' 
return deviceTypes,- 

} 



/**The handle method implements the core logic of a Connector., It takes an incoming 
request 

* from a particular device, and returns an appropriate response. This method is called 

whenever 

* the server receives a request from a type of device that the Connector indicates it 

* supports, destined (as indicated in the request URL) for a specific application. It is 

* the responsibility of the Connector to interpret the request and generate an * 

appropriate 

* response. 
* 
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* The server will pass a Device object containing as much information as possible into 

this 

* method. The Connector can then utilize the particular Device class to determine more 

detailed 

* information on the capabilities of the particular device making the request. 
* 

* ©param props is a set of name value pairs corresponding to the HTTP request parameters nr 

from 

* the device. 

* ©param device is a Device object created in the image of the actual device making this* 

request . 

* ©param result is a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle (Properties props, Device device, OutputStream result) 

//Within the renderLogin method, we name the sessionID paramater in the URL "sid" . 
//We get the value here. 

String sessionID = props . getProperty ( " sid" ) ,- 

//Find out what action the user is trying to perform 
String action = props . getProperty ( "action" ) ; 

//The User Profile is identified by a globally unique ID (the user's ThinAir User ID) 
String userProf ilelD = null; 

O //The page to be rendered 

*Q String resultString = null; 

//The cache for this session 
y Hashtable cache = null; 

lU //If this is the user's first hit, they will not yet have a session 

I if (sessionID == null) 

2 { 

W //So create one for them 

3 sessionID = access . createSession () ; 

O } 

HI //ThinAir Server administrators have control (through the User Manager tool) over 
O whether 

iS //password authentication is required for each application running on the ThinAir 
]fj Server. 

sal boolean mustAuthenticate = true; 

//Here we check if the session needs to be authenticated 

try 

{ 

mustAuthenticate = access . userAuthenticationRequiredForSession (appName , 
sessionID) ,- 

> 

//Handle the case where the session has timed out 
catch (NoSuchSessionException e) 

renderExcept ion ( "Your session has timed out. Please re-register. 1 '); 

} 

//If the ThinAir Server administrator has not required password authentication, then 
he or she 

//is allowing known devices to logon automatically, 
if (! mustAuthenticate) 

//Get the device GUID. getGuidO returns null for those devices that don't have 
GUIDs 

String deviceGUID = device . getGUID () ; 

//If the device has a deviceGUID and the userProf ilelD still hasn't been assigned 

if (userProf ilelD == null && deviceGUID != null) 

{ 

//Look up a User Profile ID from a Device GUID 
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//This userProf ilelD will later be used to both set and retrieve User Profiler 
information 

userProf ilelD = access .getUPIDFromDeviceGUID (deviceGUID) ; 

} 

} 

//If the user has not performed an action and userProf ilelD is still null, then they 

need to login 
if (action == null && userProf ilelD == null) 

{ 

resultString = renderLogin ( sessionID) 

//If we have their userProf ilelD from their deviceGUID and there is no action 

performed by the user 
else if (action == null && userProf ilelD != null) 

{ 

try 
{ 

//Set the session as authenticated 

access . setSessionAuthenticated (sessionID, true) ; 

//Gets the caller-modifiable cache for a specified session, 
cache = access .getSessionCache ( sessionID) ; 

//Place the userProf ilelD in the cache 

cache. put (USER_PROFILE_ID_ARG, userProf ilelD) ; 

//Render the menu 

resultString = renderMenu ( sessionID) ; 

} 

//Handle an expired session 
catch (NoSuchSessionException e) 

resultString = renderExcept ion ( "Your session has timed out. Please 
re-register. " ) ; 

} 

} 

//Display the menu 

else if (action != null && action . equals ( "main" ) ) 
resultString = renderMenu (sessionID) ; 

} 

//Change the profile data 

else if (action != null && action . equals ( "update" ) ) 

resultString = updateProf ileData (props , sessionID) ; 

} 

//Show the profile data 

else if (action != null && action. equals ( "show" ) ) 
resultString = renderShowNumber ( sessionID) ; 

} 

//Log in the user 

else if (action ! = null && action . equals ( "login" ) ) 
{ 

resultString = login (props, device) ; 

} 

//Show the data entry deck 

else if (action 1= null && action . equals (" set " ) ) 
{ 

resultString = this . renderSetNumber ( sessionID) ; 

} 

//Render for the device by turning the String into an array of bytes 

byte resultBytes [] = resultString . getBytes () ; 

try 

{ 

//Write the bytes to the output stream 
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result . write (resultBytes) ; 

} 

catch (IOException e) 

{ 

System. err .println ( "Error ! cannot write to result OutputStream . " ) ; 

} 



* This method renders a deck to allow the user to enter a User ID and password. 
* 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server 

Development Guide. 

* 

* ©param sessionID the unique sessionID for the user. 

* ©return A String containing the WML deck to be display to the user. 
*/ 

private String renderLogin (String sessionID) 

{ 

//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

0 //The data will be sent to the server by means of a POST so no $variables need to be / 

« set in the URL 

y //Build the URL. . . 

f~ //Some devices cache content more than they should. Adding a random parameter is an * 

\\ unbeautiful, 

//though often necessary technique for tricking the phone into always hitting the * 
server rather 
Jl //than getting a page from its local cache. 

//n.b. Certain phones (such as the Nokia WAP Toolkit Version 2.0 simulator) require / 
==1 the absolute 

//application path so we include it here 
H String url = appPath+ 11 ?action=login& sid= !, + sessionID + " &amp ; rnd= " + Math, random/ 

□ () ; 

//Create a display card 
3 Card card = new Card ( "ul " , "Welcome " ) ,- 

//The Go element is a task element that instructs the device to open a specified URL. 
Go go = new Go (url , true , Go .METHOD_POST) ; 

Labeledlnput userName = new Label edlnput (USER_PROFILE_ID_ARG, "text" , n *m" , "User ID:"); 
Labeledlnput password = new Labeledlnput (US ER_PROF I LE_PWD_ARG, "password" , " * *r 

m", "Password:") ; 
Labeledlnput [] inputs = {userName , password} ; 

//Add the post fields 

for (int i = 0; i < inputs . length ; i++) 

go.addChild (new PostField ( inputs [i] .getlnputName (),"$ " + inputs [i] .get InputName *r 
< ) > ) ; 

//Create a Do element that associates a task with an element within the user / 
interface . 

//When the user invokes the user interface mechanism, the device performs the 

associated element task. 
Do dew = new Do (Do . TYPE_ACCEPT , go) ; 

dew.addAttribute ( "label" , "Next" ) ; 

//Add the Do element to the card 
card. addChild (dew) ; 

//Create a Paragraph 
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Paragraph p = new Paragraph ( ) ; 
//Add text to the paragraph 

p.addChild(new Text { "Welcome to the Profile Connector") ) ; 
p.addChild(new Break ( ) ) ; 

for (int i = 0; i < inputs . length ; i++) 
p. addChild (inputs [i] ) ; 

//Add the paragraph to the card 
card.addChild(p) ; 

//Add the card to the deck 
deck. addChild (card) ; 

//Render the deck 
return deck . render ( ) ; 

} 



/ * * 

* This generates the main menu deck. The menu gives the user the option to either set 

their 

* favorite number or view it. This method is first called after login. 
* 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For * 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server * 

Development Guide . 

* 

* ©param sessionID - the unique session ID for the user. 

* ©return A String containing the WML deck to be display to the user. 
*/ 

private String renderMenu (String sessionID) 

{ 

//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create a display card 

DisplayCard card = new DisplayCard () ; 

//Create a Paragraph 
Paragraph p = new Paragraph ( ) ; 

p. addChild (new Text ( "Menu" ) ) ; 
p. addChild (new BreakO); 
p. addChild (new BreakO); 

//Build the URL. . . 

//Some devices cache content more than they should. Adding a random parameter is an 
unbeautif ul , 

//though often necessary technique for tricking the phone into always hitting the 

server rather 
//than getting a page from its local cache. 

//n.b. Certain phones (such as the Nokia WAP Toolkit Version 2.0 simulator) require * 

the absolute 
//application path so we include it here 

String href = appPath+ " ?act ion=set " + "& sid=" + sessionID + " &amp ; rnd= " + Math, 
random ( ) ; 

//The Go element is a task element that instructs the device to open a specified URL. 
Go go = new Go (href , true , Go . METHOD_GET) ; 

//The Anchor element anchors a task to a string of formatted text. This is often 

called a link. 
Anchor a= new Anchor (go , new Text ("Set Number") ) ; 
p. addChild (a) ; 
p . addChild (new BreakO); 




C : \TASS\ . . \General\UserProf ileManagement\src\Prof ileConnector . java 7 

//This is the action that will occur when the link is selected 

href = appPath+ "?action=show" + "&sid=" + sessionID + " &amp ; rnd= " + Math. random 
{) ; 

//The second link 

go = new Go (href , true , Go . METHOD_GET) ; 
//Create the second link 

a= new Anchor (go, new Text ( "Show Number" ) ) ; 

p. addChild (a) ; 

p. addChild (new Break ()) ; 

//Add the Paragraph to the card 
card. addParagraph (p) ; 

//Add the card to the deck 
deck . addCard (card) ; 

//Render the deck 
return deck . render ( ) ; 

} 



/** 

* This method updates User Profile Data after the user has entered a new number. 
* 

* ©param props - The Properties object containing the request parameters. 

* ©param sessionID - The user's unique session ID 
*/ 

private String updateProf ileData (Properties props, String sessionID) 
{ 

Hashtable cache = null; 
String userProf ilelD = null; 

//Get the number from the URL 

String newNumber = props . getProperty (FAVORITE_NUMBER) ; 

//If the number is null, then fill it in 
if (newNumber == null) 

newNumber = "Not Set"; 

try 

{ 

//Get the session cache 

cache = access . getSessionCache ( sessionID) ; 

//Get the userProf ilelD from the session cache 
userProf ilelD = (String) cache . get (USER_PROFILE_ID_ARG) ; 

//Get the old data from the profile 

ProfileData data = (Prof ileData) access .getUserProf ileData (userProf ilelD, appName) ; 

if (data 1= null) 

{ 

//Set the value to the newly entered number 
data . f avoriteNumber = newNumber; 

} 

else 

{ 

//Create a new profile data container 
data = new Prof ileData () ; 

//And fill it with our new number 
data . f avoriteNumber = newNumber; 

} 

//Set the profile data to our profile data container object 
access . setUserProf ileData (userProf ilelD, appName , data) ; 



//Bring the user directly to the display deck 
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return render ShowNumber ( sessionID) ; 

/Handle the case where the UserManager has changed permissions on this app 
catch (AddAppDataPermissionException e) 

return renderException ( "The Add Application Data Permission has been turned off wr 
for this application"); 

/Handle the possibility of a time-out 
catch (NoSuchSessionException e) 

return renderException ( "Your session has timed out. Please re-register."); 

//Handle the possibility that the profile no longer exists, 
catch (NoSuchUserProf ileException e) 

return renderException ( "Your Profile has been deleted. Please reregister or X 
contact your administrator. ") ; 

//Handle the possibility that the administrator is using UserManager right now 
catch (Prof ileStoreLockedExcept ion e) 

return renderException ( "The profile store cannot be updated because the Profile ^ 
Store is locked. Please try again or contact your administrator."); 



* render ShowNumber creates the markup document that displays the number. It is either 

called 

* when the user selects 'show number' from the main menu or after the user has set the \£ 

number . 

* 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For ur 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server \l 

Development Guide . 

* 

* ©param sessionID the unique ID for this user's session. This will be displayed to the* 

user. 

* ©return A String containing the WML deck to be display to the user. 
*/ 

private String render ShowNumber (String sessionID) 

{ 

Hashtable cache = null; 
String userProf ilelD = null; 
String number - null; 
try 

{ 

//Get the session cache 

cache = access . getSessionCache (sessionID) ; 

//Get the User Profile ID from the session cache 
userProf ilelD = (String) cache . get (USER_PROFILE_ID_ARG) ; 

ProfileData data = ( Prof ileData) access . getUserProf ileData (userProf ilelD, appName) ,- 

//The data has not yet been set 
if (data == null) 

number = "Not Set"; 

else 

number = data . favor it eNumber; 

} 

catch (NoSuchSessionException e) 

return renderException ( "Your session has timed out. Please re- register .") ; 

} 
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//Handle the rare case where the profile has been deleted by someone during our 
session 

catch (NoSuchUserProf ileException e) 

^ return renderExcept ion ( "Your profile has been removed. Please re-register or * 
contact your administrator."); 

} 

//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create a display card 

DisplayCard card = new DisplayCard () ; 

//Create a Paragraph 
Paragraph p = new Paragraph ( ) ; 

//Display the user's sessionID 

p.addChild(new Text ("Your number is: "+ number)); 
//Build the URL. . . 

//Some devices cache content more than they should. Adding a random parameter is an >£ 
unbeautiful, 

//though often necessary technique for tricking the phone into always hitting the 
server rather 
□ //than getting a page from its local cache. 

0 //n.b. Certain phones (such as the Nokia WAP Toolkit Version 2.0 simulator) require yt 

& the absolute 

//application path so we include it here 
[ 4 String href = appPath+ " ?action=main n + "& sid=" + sessionID + " &amp rnd= " + Math.* 

E random ( ) ; 

*1 //The go element is a task element that instructs the device to open a specified URL. 

^ Go go = new Go (href , true , Go .METHOD_GET) ; 

//Create a do element that associates a task with an element within the user 
interface . 

//When the user invokes the user interface mechanism, the device performs the \£ 
M associated element task. 

3 Do dew = new Do (Do . TYPE_ACCEPT, go) ; 

fj p. addChild (dew) ; 

^ //Add the Paragraph to the card 

card.addParagraph(p) ; 

//Add the card to the deck 
deck. addCard{ card) ,* 

//Render the deck 
return deck . render () ; 

} 



* This is a simple card that renders a user interface that allows the user to set a 

number 

* that will be saved in the user's User Profile. 
* 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For 

more 

* information on use of the Tag Libraries, see the Tag Library documentation and the 

* ThinAir Server Development Guide. 
* 

* ©param sessionID the uniques ID for the user's session. 

* ©return A String containing the WML deck to be display to the user. 
*/ 

private String renderSet Number (String sessionID) 
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{ 

//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
//Create a display card 

MultiplelnputCard card = new MultiplelnputCard {) ; 

//Create a Paragraph 
Paragraph p = new Paragraph ( ) ; 

//set the action 
//Build the URL. . . 

//Some devices cache content more than they should. Adding a random parameter is an 
unbeautif ul , 

//though often necessary technique for tricking the phone into always hitting the 

server rather 
//than getting a page from its local cache. 

//n.b. Certain phones (such as the Nokia WAP Toolkit Version 2.0 simulator) require * 

the absolute 
//application path so we include it here 

String href = appPath+ "?action=update& " + "sid=" + sessionlD + "&rnd=" + * 
Math.randomO + "& H + FAVOR I TE_NUMB E R +"=$"+ FAVORITE_NUMBER ; 

//*N means that only numbers can be entered 
^ Labeledlnput number = new Label edlnput ( FAVORITE_NUMBER, "text " , " *N" , "Pick a number:"); 

™ s Labeledlnput [] inputs = {number}; 

p card. buildCard (href , " submit " , inputs , Go . METHOD_GET) ; 

^ //Add the card to the deck 

2 deck. addCard (card) ; 

E j //Render the deck 

~ ; return deck . render () ; 



* The login method gets called after the user has entered their user ID and password. 'If* 

the 

* userProf ilelD they entered already exists, it tries to authenticate the password. If *r 

the 

* password is wrong, it returns an error saying that this is the case. If the password 

* is correct, it stores the userProf ilelD in the session cache for future use, sets 

* the session to be authenticated and renders the main menu. 
* 

* If the userProf ilelD the user entered does not exist, then the Connector tries to 

create one with the 

* given userProf ilelD . This will work unless the administrator has set permissions to 

not allow the 

* creation of new user profiles. If the Connector does not have permission, then a 

message 

* saying that will be returned. 
* 

* ©param props The properties object passed into handle containing the request arguments 

* ©param device the device making the request. We use this when we create the profile 

so that it can be 

* associated with the user. 
*/ 

private String login ( Properties props, Device device) 

{ 

//Get the sessionlD from the request 

String sessionlD = props . getProperty (" sid" ) ,- 

//Get the user profile ID from the request 

String userProf ilelD = props . getProperty (USER_PROFILE_ID_ARG) ; 
//Get the password from the request 

String pass = props . getProperty (USER_PROFILE_PWD_ARG) ; 



C: \TASS\ . . \General\UserProf ileManagement\src\Prof ileConnector. java 



11 



Hashtable cache = null; 

//Check to see if the User Profile exists 
if (access . userProf ileExists (userProf ilelD) ) 

{ 

boolean valid = false ,- 
try 

//Authenticate the User Profile ID and password 
valid = access . authenticateUser (userProf ilelD, pass) ,- 

//If the login was successful 

if (valid) 

{ 

//Set the session to be authenticated 

access . setSessionAuthenticated ( sessionlD, true) ; 

//Get the session cache 

cache = access . getSessionCache ( sessionlD) ; 

//Place the userProf ilelD in the cache 
cache. put (USER_PROFILE_ID_ARG, userProf ilelD) ; 

//Bring them to the main page 
Q return renderMenu ( sessionlD) ; 

} 

//A rare case where the profile was deleted between our call to access. ^ 
: sj userProf ileExists (userProf ilelD) 

: jg //and access .authenticateUser (userProf ilelD, pass) ; 

{ \i catch (NoSuchUserProf ileException e ) 

~H return renderExcept ion ( "Your profile has been deleted or changed. Please 

m re-register or consult your administartor . " ) ; 

":~ } 

\v~ m //Their session has timed out 

catch (NoSuchSessionException e) 

return renderExcept ion ( "Your session has timed out. Please log in again."); 

It } 
I s - ) 

!□ //The userProf ilelD they entered is not in the profile store, so try to create xt 

Ijl else 
{ 

try 

//This creates the profile and adds the device to its list 
access . createUserProf ile (userProf ilelD, pass , appName , device) ; 

//Set the session as authenticated 

access . setSessionAuthenticated { sessionlD, true) ; 



//Get the session cache 

cache = access . getSessionCache ( sessionlD) ; 

//Place the userProf ilelD in the cache 
cache. put (USER_PROFILE_ID_ARG, userProf ile ID) ; 

//Bring them to the main page, 
return renderMenu ( sessionlD) ; 

//A rare case where someone else has created a User Profile with the same name 
catch (Prof ileAlreadyExistsExcept ion e) 

return renderExcept ion ( "This Profile ID is already taken. Please choose 
another . " ) ; 

//If the administrator has set permission to disallow connectors from creating 
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profiles 

catch (AddProf ilePermissionException e) 

return renderException ( "The ThinAir Server administrator has disallowed the 
creation of new profiles!"); 

//The administrator has locked the store to run UserManager 
catch (Prof ileStoreLockedException e) 

return renderException ( "The ThinAir Server profile store is currently being * 
configured. Try again later." ); 

//Their session has timed out 
catch (NoSuchSessionException e) 

return renderException ( "Your session has timed out. Please re-register."),- 



//If none of the above exceptions occurred, then they entered an invalid * 

userProf ilelD 
//or a bad password or both 

return renderException ( "Your user ID or password was incorrect. Please try again."); 



* renderException creates a markup document with an error message. 
* 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server * 

Development Guide . 

* 

* ©param message The error message to be displayed to the user. 

* ©return A String containing the WML deck to be display to the user. 
*/ 

private String renderException (String message) 

{ 

//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create a display card 

DisplayCard card = new DisplayCard () ; 

//Create a new paragraph 
Paragraph p = new Paragraph {) ; 

p . addChild (new Text (message) ) ; 
p.addChild(new Break () ) ; 

//Create the URL 

String href = appPath+ " ?rnd= "+Math . random () ; 

//The go element is a task element that instructs the device to open a specified URL. 
Go go = new Go (href , true , Go . METHOD_GET) ; 

//The anchor element anchors a task to a string of formatted text. This is often 
called a link. 

Anchor anchor = new Anchor (go , new Text("Start again. . . " ) ) ; 

//Add the anchor to the the paragraph 
p . addChild (anchor) ; 

//Add the paragraph to the card 
card. addParagraph (p) ; 

//Add the card to the deck 
deck. addCard (card) ; 
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} 



} 



//Returns the entire rendered document text, suitable for display in an WML browser 
return deck . render {) ; 





README . tXt 



Session Management Sample Connector 



wireless SDK for ThinAir server vl.2 



About this Sample 

This sample connector demonstrates the use of Sessions within the ThinAir 
Connector API. when the user first contacts the server, the Session Management 
Connector creates a session object for that user and assigns it a unique 
session identifier. This session ID is then passed along back and forth to 
the device as a parameter of the HTTP request string. In this way the session 
persists each time the 'Hit again 1 button is pressed, while the 'Hit #' 
increases. 

n.b. This sample connector is written for wml devices only. 



Requi rements 

;3|his sample requires the following SDK jars: 
?Q * platform. jar 
-^j * taglib.jar 

Jhis sample does not require any other external apis. 



Sample Files 

IT!™"" 

• r r=r 

iThis sample consists of the following file tree: 
y connector.ini - connector configuration file 
]C Sessionconnector .class - compiled Java code 
m /src - java source file - sessionconnector. java 



^"Building the sample 



Compile the sample code using the Java compiler of your choice. Make sure to 
append the required class files above into your CLASSPATH. 

Install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir server's /connectors subdirectory, given a name 
of your choice. 

Start the ThinAir server, it will load the sample code and begin executing it. 



using the sample 



wait until the Thi nAi rserver has started and the session Management connector 
has been loaded and initialized. From your wireless html device, or web 
browser, enter the IP address listed as the value for ApplicationPath in 
connector.ini (your Thi nAi rserver IP address), followed by /samples/session. 
For a machine with IP address 111.222.12.34 this would be: 

http://lll.222.12 . 34/sampl es/session 

Follow the on-screen instructions. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 



//Core ThinAir Server API functionality 
import com . thinairapps . platform . connector . * ; 
import com. thinairapps. platform. except ion. * ; 
import com. thinairapps . platform . device . * ,- 

//Rendering packages used to build markup 
import com . thinairapps . tag . * ; 
import com. thinairapps . tag . wml . * ; 

//Core Java API 
import java .util . * ; 
import j ava . io . * ; 



/ ** 

* @ (#) SessionConnector . java 
* 

* This sample Connector demonstrates the use of sessions within the ThinAir Connector API. 
i<=3 * A session is created when the user first contacts the Connector. The Connector generates 
J* a unique session ID that is then passed back and forth between the server and client with 
y* each HTTP request and response. When using HTTP GET, this means adding a parameter to the 
D * URL that specifies the session ID. With HTTP POST, it involves adding a POST parameter \£ 
q for 

* the session ID in much the same way. 

K*/ 

public class SessionConnector implements Connector 

-I 

?% ConnectorAccess access ; 
String appPath ; 

/**init() is called by the ThinAirServer when the Connector is loaded. It provides the 
Connector with 

* resources it needs to interact with the ThinAirServer. 
* 

* ©param applicationName indicates the friendly name of the application of which this 

Connector is a part. 

* It is a String derived from connector.ini and this sample does 
not utilize it. 

* ©param applicationPath is the path to the application of which this Connector is a *r 

part . 

* It is a String derived from connector.ini and this sample does >l 
utilize it. 

* ©param connectorProps is a Properties object containing developer assigned, 

connector-specific properties. 

* It is derived from connector.ini and this sample does not * 
utilize it. 

* ©param ConnectorAccess is the one-and-only interface a Connector obtains to gain 

access to the runtime 

* services offered by the ThinAir Server to running Connectors. ^ 
This sample uses 

* it to create a session and store and retrieve data from the * 
session cache. 

* ©param appLog is used for Logging 
*/ 

public void init (String applicationName, String applicationPath, Properties * 
connectorProps, ConnectorAccess ConnectorAccess, com. thinairapps . platform . connector . \£ 
ApplicationLog appLog) 

{ 

access = ConnectorAccess ,- 
appPath = applicationPath; 

} 
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/★★getDevices ( ) is called once by the ThinAir Server during start-up. It allows a / 
Connector to 

* indicate the types of devices it supports. getDevices () returns an array containing * 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used * 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer * 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getName ( ) method. 
* 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 

* ThinAir Server Developer Guide. 
* 

* ©return an array of Strings representing the friendly names of the devices this 

Connector supports. 

*/ 

public String [] getDevices ( ) 

{ ■ 

String deviceType = " TA_WAP " ; 
String [] deviceTypes = {deviceType}; 

return deviceTypes; 

ft } 



/**The handle method implements the core logic of a Connector. It takes an incoming uf 
request from a 

* particular device, and returns an appropriate response. This method is called whenever/ 

the server 

* receives a request from a type of device that the Connector indicates it supports, 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of 

the Connector 

* to interpret the request and generate an appropriate response. 
* 

* The server will pass a Device object containing as much information as possible into 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed 

information 

* on the capabilities of the particular device making the request. 
* 

* ©param reqProps - represents the HTTP request 

* ©param device - the actual wireless device instance making the request 

* ©param out - the OutputStream to write back the response 
*/ 

public void handle (Properties props, Device device, OutputStream result) 

{ 

//A count of the number of times the user has hit the server during this session 
Integer hitNumber = null; 

//Within the renderPage method, we name the sessionID parameter in the URL "sid" 
String sessionID = props . getProperty ( " sid" ) ; 
//The cache for this session 
Hashtable cache = null; 

//If this is the user's first hit, they will not yet have a session 
if (sessionID == null) 

{ 

//So create one for them 

sessionID = access . createSession () ; 

} 

try 
{ 

//Get the cache for this session 

cache = access .getSessionCache (sessionID) ; 
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} 

catch (NoSuchSessionException e) 

//Can pass any exception messages to the exception rendering method 

} 

//Get a reference to the value to which the key is mapped in the cache hashtable 
hitNumber = ( Integer ) cache . get ( "hit ") ; 

//The value is null if the key is not yet mapped to any value in the cache hashtable 
//This must be the user's first time through 
if (hitNumber == null) 
{ 

//Create the first hit 
hitNumber = new Integer (1) ; 

//And store it in the cache 
cache .put { "hit " , hitNumber) ; 

} 

//They have been here before 
else 

{ 

//So increment the existing count 

hitNumber - new Integer (hitNumber . intValue ( ) + 1) ; 

3 //And store it in the cache 

S cache .put ( "hit 11 , hitNumber) ; 

s| //Now render the result 

?~ String resultString = renderPage (sessionID, hitNumber) ; 

^ //Turn the String into an array of bytes 

''4 byte resultBytes [] - resultString . getBytes () ; 

try 
{ 

a! //Write the bytes to the outputStream 

H result .write (resultBytes) ; 

=i } 

:I catch (IOException e) 

ji { 

3 //Write to the 'standard' error output stream 

\ System . err . print In ( "Error ! cannot write to result OutputStream."); 
} 



/**renderPage creates the markup document to be displayed. This sample only supports WAP* 
devices 

* (as indicated in the getDevicesO method) and it makes use of the ThinAir WML Tag 

Library for 

* WML markup creation. 
★ 

* ©param sessionID is the unique ID for this user's session. This will be displayed to 

the user. 

* ©param hitNumber is an Integer representing how many times the user has hit the servers 

during this session. 

* 

* ©return a String containing the WML deck to be display to the user. 
*/ 

private String renderPage (String sessionID, Integer hitNumber) 

{ 

//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create a display card 

DisplayCard card = new DisplayCard ( ) ; 
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//Create a Paragraph 

Paragraph p = new Paragraph (Paragraph. AL I GN_RIGHT, Paragraph . MODE_NOWRAP) ; 

//Display the user's sessionID 

p. addChild(new Text ("Session: "+ sessionID)); 

p. addChild (new Break () ) ; 

//Display the user's hit count 

p. addChild (new Text ("Hit #:" + hitNumber . toString ( ) ) ) ; 
p . addChild (new Break ( ) ) ; 

//Create a random parameter to be added to the URL later 

//Adding the empty string to the end of Math . random ( ) converts the result from a 

double to a string 
String rnd = Math . random ( ) + " " ; 
rnd = rnd. substring (2 , 6) ; 

//Build the URL. . . 

//Some devices cache content more than they should. Adding a random parameter is an \i 
unbeautif ul , 

//though often necessary technique for tricking the phone into always hitting the 

server rather 
//than getting a page from its local cache. 

//n.b. Certain phones (such as the Nokia WAP Toolkit Version 2.0 simulator) require \£ 

the absolute 
//application path so we include it here 

String href = appPath+ "?sid= M + sessionID + " &amp ; rnd= " +rnd; 

//Constructs a Go tag with the appropriate URL and link method. 
Go go = new Go ( hre f , t rue , Go . METHOD__GET ) ; 

//Specifies the action to perform when the user activates the link and the text the * 

device will 
//Display to represent the link. 

Anchor anchor = new Anchor (go, new Text ( "Hit again...")); 

//Add the anchor to the Paragraph 
p . addChild (anchor) ; 

//Add the Paragraph to the card 
card. addPa rag raph (p) ; 

//Add the card to the deck 
deck. addCard (card) ; 

//Render it (that is, turn it into a String) 
String resultString = deck . render () ; 



//Returns the entire rendered document text, suitable for display in a WML browser 
return resultString; 



README . txt 



Logging connector sample Connector 
wireless SDK for ThinAir server 



About this Sample 



This connector demonstrates the logging capabilites of the ThinAir server, it 
is a HTML only connector 



Requi rements 



This sample requires the following SDK jars: 

* platform. jar 

* taglib.jar 



i^ample Files 



jShis sample consists of the following file tree: 
'*J connector.ini - connector configuration file 
p Loggingconnector .class - compiled Java code 
l^t /src - java source file - DBconnector . java 



building the Sample 



•■Compile the sample code using the Java compiler of your choice. Make sure to 
Append the required jar files above into your classpath. 

■fjnstall the compiled sample code and connector.ini configuration file into a 
I Jubdi rectory of the ThinAir Server* s /connectors subdirectory, given a name 
'{of your choice. 

The logging API's uses settings in connector.ini file to place the log entries. 
Your connector.ini must have an [Output] section followed by 
[level] = [destination]. 

Example: 
[Output] 

Critical = stderr, file: logs\Cri tical Log .txt 
Error = STDERR, FILE : 1 oqs\Er rorLog . txt 
warning = stdout, FILE :Togs\warningLog .txt 
info = stdout, file: logs\infoLog.txt 

consult the Developers guide for more information 

Start the ThinAir Server, it will load the sample code and begin executing it. 



using the Sample 



wait until the Thi nAi rServer has started and the DBconnector has 
been loaded and initialized. From your wireless wml device, or web browser, 
enter the IP address listed as the value for Appl i cationPath in connector.ini 
(your ThinAirserver IP address), followed by /sampl es/Loggi ngConnector . For 
a machine with IP address 111.222.12.34 this would be: 
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http : //111 . 222 . 12 . 34/sampl es/Loggi ngconnector 
Follow the on-screen instructions. 



Last updated: 11.13.2000 
Copyright 1999, 2000 ThinAirApps inc. 




page 2 



C : \TASS\WirelessSDK\Samples\General\Logging\src\LoggingConnector . j ava 1 

/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Standard ThinAir server imports 
import com. thinairapps . platform. connector . * ; 
import com. thinairapps .platform. device . * ; 
import com . thinairapps . tag . html . * ; 

//Standard Java Imports 
import java.util.*; 
import j ava . io . * ,- 

/** 

* This Connector is for demonstrating the Logging capabilities of the ThinAir Server. The 

user can select 

* which log file to write to. The location of the log file is determined by the connector. * 

ini 

* settings. Please refer to the JavaDocs for a comprehensive list of the methods available. 
* 

*/ 

public class LoggingConnector implements Connector 
{ 

ApplicationLog appLog; 
l T String appPath; 



™ /**init() is called by the ThinAirServer when the Connector is loaded. It provides the 
?~ Connector with 

U * resources it needs to interact with the ThinAirServer. 

r,J * For more information about the Connector interface, see the javadocs for the ThinAir * 
Server API 

* ©param appName is a String derived from connector.ini. We used this to format our 
5 action field in the form tag 

^ * ©param ap is a String derived from connector.ini. We don't need this for this sample.. 
lj * ©param props is a Properties list containing developer assigned connector- specif ic 
y properties. 

fjj * We don't need this parameter in this sample. 

^ * ©param connectorAccess is our access point to the services provided by ThinAir Server * 

. We don't need this for this sample. 
^ * ©param al is the Application Log instance that we use to write to the appropiate logs 
We used this to write to logs 

*/ 

public void init (String appName, String ap, Properties props, ConnectorAccess ca, *r 
ApplicationLog al) 

{ 

//Set the two values 
appLog = al ; 
appPath = ap; 

} 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a ^ 
Connector to. 

* indicate the types of devices it supports. getDevicesO returns an array containing ^ 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used * 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getName ( ) method. 
■*■ 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 
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* ThinAir Server Developer Guide. 
* 

* ©return an array of Strings representing the friendly names of the devices this / 

Connector supports. 

*/ 

public String [] getDevicesO 
{ 

String devices [] = { " TA__HTML " } ; 
return devices; 

} 



/**The handle method implements the core logic of a Connector. It takes an incoming wr 
request from a 

* particular device, and returns an appropriate response. This method is called whenever/ 

the server 

* receives a request from a type of device that the Connector indicates it supports, / 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of / 

the Connector 

* to interpret the request and generate an appropriate response v 
* 

* The server will pass a Device object containing as much information as possible into / 
13 this method. 

* The Connector can then utilize the particular Device class to determine more detailed / 
.J: information 

* on the capabilities of the particular device making the request. 

~"~d * 

_P * ©param reqprops a set of name value pairs corresponding to the HTTP request parameters/ 
from the device. 

*>r= * ©param dev a Device object created in the image of the actual device making this / 
""~4 request. 

m * ©param out a reference to the OutputStream that will be returned to the device. 

] :J */ 

K _ public void handle (Properties reqprops, Device dev, OutputStream out) 

*d { 

jjjl String result; 

P~ int actionCode; 

;J String sactcode; 

13 //Get the actionCode from the form, if this the first time through, then getProperty / 

rr will return null 

sactcode = reqProps . getProperty ( "actionCode " ) ; 

//Since this is the first time through we do not need to check, so we set actionCode / 

to zero 
if (sactcode — null) 

actionCode = 0; 

else 

//otherwise we parse actionCode into a int 

actionCode = Integer .parselnt (sactcode) ; 
Form mainForm; 
String msgString = " " ; 

//Start Generating HTML 

HTMLTagDocument htmlDoc ~ new HTMLTagDocument ( ) ; 
Head htmlHead = new Head ( ) ; 
htmlDoc.addChild(htmlHead) ; 
Body htmlBody = new Body ( ) ; 

//check whether actionCode has been set 
if (actionCode 0) 

{ 

//test actionCode 
switch (actionCode) 

{ 
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//Using the instance of ApplicationLog that was passed in the init method 
//and depending on what the actionCode is, we call the appropiate logger *r 
method . 

//The logging methods uses the following conventions: 

//logXXX (<string of method call>, <error code>, <message>, <boolean of * 

whether or not to display the connector name>) 
//where XXX is the log Level name (Emergency, Critical, Alert, Error, Warnings 

, Notice, Info, Debug) 
//for more detail information, please refer to the Developers Guide 
case 1 : 

appLog. logEmergency ("handle () 1100, "Emergency message- Indicate fatal * 
conidition, probably resulting in exception every time code is excuted" , * 
true) ; 

msgString - "An Emergency message was written to the location specified in 

connector. ini" ; 
break ; 
case 2 : 

appLog . logCr it ical ( "handle ( ) " , 2100, "Critical message-Critical conditions, * 

such as hard device errors", false); 
msgString = "A Critical message was written to the location specified in 

connector . ini " ; 
break ; 
case 3 : 

appLog . logAlert ( "handle ()" , 3100, "Alert message-A condition to be corrected 
immediately, such as a corrupt system", true) ; 
™ ; msgString = "An Alert message was written to the location specified in 

^ connector . ini " ,- 

^ break ; 

0 case 4 : 

j appLog . logError ( "handle ()" , 4100, new Exception ( "Throwing Exception for ^ 

Z Logging Error"), true) ; 

r 5 msgString = "An Exception was thrown to the location specified in connector, 

il ini"; 
d break; 
^ case 5 : 

^ appLog . logWarning ( "handle ()" , 5100, "Warning message- Indicate an unusual ^ 

condition that the app will handle automatically but which is noted in 
3 the log to help diagnose futre errors", false); 

jS msgString = "A Warning message was written to the location specified in 

L; connector . ini " ; 

=? break ; 

H case 6 : 

^ appLog . logNot ice ( "handle ()" , 6100, "Notice message-Conditions that are not 

^ errors, but may require special handling", false) ; 

msgString = "A Notice message was written to the location specified in \£ 

connector . ini " ; 
break ; 
case 7: 

appLog . loglnfo ( "handle ()" , 7100, "Info message-Normal Status message", true); 
msgString = "An Info message was written to the location specified in * 

connector . ini " ; 
break ; 
case 8 : 

appLog . logDebug ( "handle {)" , 8100, "Debug message-for logging debug msgs 

during development process", false); 
msgString = "A Debug message was written to the location specified in ^ 

connector . ini " ; 
break ; 
default : 

break ; 

} 

//Add the msg to HTML 

htmlBody . addChild (new Text (msgString) ) ; 
htmlBody . addChild (new Break ( ) ) ; 



//Construct the mainSelection Form 
mainForm = renderMainSelection ( ) ; 
htmlBody . addChild (ma inForm) ; 



# 
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htmlDoc.addChild(htmlBody) ; 

//Render the HTML. 

result = htmlDoc . render () ; 

try 

{ 

//Write out 

out .write (result .getBytes ( ) ) ; 

} 

catch (Exception e) 

{ 

//Catch the exception 

appLog . logError ( "handle ()" , 4100, "Error writing to Outputstream : 11 + e. 
getMessageO , true) ; 

} 

} 

//This function creates the Form using the HTML tag libraries 

public Form renderMainSelection ( ) 

{ 

Form formtag = new Form ( "Logging' 1 , appPath, "GET" ); 

f ormtag .addChild (new Text (" Please select which Log you would like to write to:")); 
f ormtag .addChild (new Break ()) ; 
3 formtag -addChild (new Text ("Emergency") ) ; 

^ Input emergencylnput = new Input (" radio" , "act ionCode" , "1"); 

formtag . addChild (emergencylnput ) ; 
formtag . addChild (new Break ()) ; 

^ l 

p formtag . addChild (new Text ( "Critical ")) ; 

^ Input alertlnput = new Input ( "radio" , "actionCode" , "2"); 

U formtag .addChild (alertlnput) ; 

-J formtag .addChild (new Break ( ) ) ,- 

fe " formtag. addChild (new Text ( "Alert " ) ) ; 

Input criticallnput = new Input ( "radio" , "actionCode " , "3"); 
□ formtag . addChild (criticallnput ) ; 

p formtag . addChild (new Break ( ) ) ; 

^ formtag. addChild (new Text ("Error") ) ; 

Jl Input errorlnput - new Input ( "radio" , "actionCode", "4"); 

3 formtag .addChild (errorlnput ) ; 

formtag .addChild (new Break ()) ; 

formtag .addChild (new Text ( "Warning" ) ) ; 

Input warnlnput = new Input (" radio" , "actionCode", "5" ) ; 
formtag .addChild (warn Input) ; 
formtag . addChild (new Break ( ) ) ,- 

formtag . addChild (new Text ( "Notice" ) ) ,- 

Input noticelnput = new Input ( "radio" , "actionCode", "6"); 
f ormtag .addChild (not icelnput) ,- 
formtag - addChild (new Break ( ) ) ; 

formtag - addChild (new Text ( " Info" ) ) ; 

Input infolnput = new Input (" radio" , "actionCode", "7"); 
formtag . addChild ( infolnput ) ; 
formtag . addChild (new Break ()) ,- 

formtag . addChild (new Text ("Debug") ) ; 

Input debuglnput = new Input ( " radio" , "actionCode", "8"); 
formtag . addChild (debug Input ) ; 
formtag . addChild (new Break ()) ; 

formtag . addChild (new SubmitBut ton ( "Submit ") ) ; 



return formtag; 



# 
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} 

} 



f 
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html Rendering Sample Connector 



wireless SDK for ThinAir Server 



About this sample 

This sample Connector demonstrates the use of the html Tag library to accept 
input from HTML forms and render output for html browsers. 



Requi rements 

This sample requires the following SDK jars: 

* platform. jar 

* taglib.jar 

This sample does not require any other external APIs. 



igample Files 

■ihis sample consists of the following file tree: 
*F connector.ini - connector configuration file 

HTMLRendererConnector. class - compiled Java code 
i& /src - j'ava source file - HTMLRendererConnector .java 



fjSuilding the Sample 

Compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your classpath. 

install the compiled sample code and connector.ini configuration file into a 
"^Subdirectory of the ThinAir Server's /Connectors subdirectory, given a name 
of your choice. 

Start the ThinAir server, it will load the sample code and begin executing it. 



using the sample 

wait until the Thi nAi rserver has started and the html Rendering connector has 
been loaded and initialized. From your wireless html device, or web browser, 
enter the IP address listed as the value for Appl icationPath in connector.ini 
(your ThinAi rserver IP address), followed by /samples/html. For a machine with 
IP address 111.222.12.34 this would be: 

http : //111 . 222 . 12 . 34/sampl es/html 

Follow the on-screen instructions. 



Last updated: 11.13.2000 
Copyright 1999, 2000 ThinAirApps inc. 
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/ * * 

* © (#) HTMLRendererConnector 
* 

* Copyright (c) 2000 ThinAirApps , Inc. All Rights Reserved 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE - ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

*/ 



//ThinAir Platform import 

import com . thinairapps . platform . connector . * ; 
import com . thinairapps . platform . device . * ; 

//ThinAir Tag Libraries import 
import com . thinairapps . tag . * ,- 
import com . thinairapps . tag . html . * / 



//Standara Java import 
import java.util.*; 
^mport j ava . io . * ; 



J** 

^!* This is a simple sample whose purpose is to illustrate the use of the ThinAir HTML 
Tag Library. It creates two simple HTML decks: the first prompts the user for their 

J* favorite color, username and password, the second simply echos the submitted values. 

~=5* This sample makes use of HTMLTagDocument , Body, Form, Labeledlnput , PasswordField, Select, 
Option, SubmitButton, Table, TableRow and TableCell . 

* 

3* For a comprehensive reference of the HTML Tag Library, see the ThinAir Javadoc API i 

& documentation. 

^*/ 

public class HTMLRendererConnector implements Connector 

2 

String path; 

//The friendly name of this sample app 
String appName ; 

//Our access point to the services of ThinAir Server 
Connect or Access access; 



/ * * 

* init() is called by the ThinAirServer when the Connector is loaded. It provides the 

* Connector with resources it needs to interact with the ThinAirServer. 
* 

* For more information about the Connector interface, see the ThinAir Javadoc API 

documentation . 

* 

* ©param appl icat ionName is a String derived from connector.ini. We don't need this for/ 

this sample. 

* ©param applicat ionPath is a String dervid from connector.ini. We don't need this for / 

this sample. 

* ©param connectorProps is a Properties list containing developer assigned 

connector- specif ic properties. 

* We don't need this parameter in this sample. 

* ©param connectorAccess is our access point to the services provided by ThinAir Server 

We don't need this for this sample. 

* ©param Appl icat ionLog is used for Logging. We do not use this parameter in this / 

sample 
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public void init (String applicationName, String applicationPath , Properties * 
connectorProps, ConnectorAccess connectorAccess, ApplicationLog al) 

{ 

appName = applicationName; 
access = connectorAccess; 
path - applicationPath; 



f * * 

* getDevicesO is called once by the ThinAir Server during start-up- It allows a / 

Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 

the names of all 

* DeviceProf iles supported by this Connector- These names are the friendly names used *<r 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getName ( ) method. 
* 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 

* ThinAir Server Developer Guide. 
★ 

* ©return an array of Strings representing the friendly names of the devices this / 

Connector supports. 

*/ 

public String [] getDevicesO 
{ 

String deviceType = 11 TA HTML"; 

String deviceTypes [ ] = J deviceType }; 

return deviceTypes; 

} 



/ ** 

* The handle method implements the core logic of a Connector. It takes an incoming / 

request from a 

* particular device, and returns an appropriate response. This method is called whenever/ 

the server 

* receives a request from a type of device that the Connector indicates it supports, wr 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of *r 

the Connector 

* to interpret the request and generate an appropriate response. 
* 

* The server will pass a Device object containing as much information as possible into / 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed / 

information 

* on the capabilities of the particular device making the request. 
* 

* ©param props a set of name value pairs corresponding to the HTTP request parameters / 

from the device. 

* ©param device a Device object created in the image of the actual device making this 

request . 

* ©param result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle ( Properties props, Device device, OutputStream result) throws ^ 
IOException 

{ 

String resultString = null; 

//get the 'action' parameter from the request. 

//This is an HTTP param we define to determine what action to take when we get a 
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request . 

String action = props . getProperty ( "a " ) ; 

//if this is the first hit (or any request for the main deck) 
if (action == null) 

// build a deck that lets the user enter information. 
resultString = renderWelcome ( ) ; 

//if they have already entered the information, then display it... 
else if (action. equals { "display" ) ) 

//build a display deck with the entered info, pass the request properties in. 
resultString = renderAnswers (props) ; 

} 

result .write (resultString .getBytes ( ) ) ; 

} 



/ ** - 

* This method renders a page with a form for entering information. . . 
* 

* ©return the rendered page . 
*/ 

private String renderWelcome ( ) 

{ 

//create the page 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

//create the body 

Body body = new BodyO ; 

//set the background color 

body . addAt t r ibu t e ( " bgcolor " , " # f f f f f f " ) ; 

Bold bold = new Bold ( ) ; 

//add a title 

bold.addChild (new Text ( "Render HTML Connector: Welcome") ) ; 
body. addChild (bold) ; 
//create a input Form 

Form form = new Form ("render", path + " ?a=display" , "POST"); 

form. addChild (new HorizontalRule ( ) ) ; 

//Create a dropdown list... 

Select colorSelect = new Select ("color") ; 

//create some choices 

Option red = new Option ("r", "Red") ; 
Option orange = new Option ( "o" , "Orange" ) ; 
Option yellow = new Option ("y", "Yellow") ; 
Option green = new Option ( "g" , "Green" ) ; 
Option blue = new Option ( "b" , "Blue" ) ; 
Option indigo = new Option ("i", "Indigo") ; 
Option plaid = new Option ( "p" ," Plaid" ) ; 

//add the choices 
colorSelect . addOpt ion ( red) ; 
colorSelect . addOption (orange) ; 
colorSelect . addOption (yellow) ; 
colorSelect . addOption (green) ; 
colorSelect . addOption (blue) ; 
colorSelect . addOption (indigo) ; 
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colorSelect . addOption (plaid) ; 
Bold colorLbl = new BoldO; 

colorLbl .addChild(new Text ( "Favorite color: ")); 

//add a label 

form. addChi Id (colorLbl) ; 

//add the select to the Form 

f orm. addFormElement (colorSelect) ; 

form. addChild (new Break () ) ; 

//add an input field 

form. addFormElement (new Label edlnput ( "usr" , "Username : " ) ) ,* 
form. addChild (new Break ( ) ) ; 
//create a password field 

PasswordField pwdlnput = new PasswordField ( "pwd" ) ; 
//add a label 

form. addChild (new Text ( " Password : " ) ) ; 

//add the password field 
form. addFormElement (pwdlnput) ; 
J form. addChild (new Break ()) ,- 

ff form. addChild (new HorizontalRule ( ) ) ; 

fl form. addChild (new Break ( ) ) ; 

^ //add a button. . . 

^! form. addFormElement (new SubmitButton ("Next")); 

y body . addChild (form) ; 

^ doc . addCh i 1 d ( body ) ; 

3 String resultString = doc . render () ; 

y return resultString; 

z } 




/ ** 

* Create a page with the results of the query above 
* 

* ©param props Properties of user responses 
* 

* ©return String of HTML page for display 
*/ 

private String renderAnswers ( Properties props) 

{ 

//get the arguments passed from the welcome deck 
String usrName = props . getProperty ( "usr ") ; 
String password = props .getProperty ( "pwd" ) ; 

//this will be a single letter, so we have to map it to a color 
String color = props . getProperty ( "color ") ; 
if (color == null) 

return renderExcept ion ( "Error ! No color was entered."); 
if (color . equals ( "r" ) ) 

color = "Red" ; 
else if (color . equals ( "o" ) ) 

color = "Orange"; 
else if (color .equals ( "y" ) ) 

color = "Yellow" ; 
else if (color . equals ( "g" ) ) 

color = "Green" ; 
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else if (color . equals ( "b" ) ) 

color = "Blue" ; 
else if (color . equals ( "i" ) ) 

color = "Indigo"; 
else if (color . equals ( "p" ) ) 

color = "Plaid"; 

//create the page 

HTMLTagDocument page = new HTMLTagDocument ( ) ; 

Body body = new Body ( ) ; 

//set the background color 

body . addA 1 1 r i bu t e ( " bg c o 1 o r " , » # f f f f f f " ) ; 

//create a new Table with a thin border 
Table table = new Table (1); 

//create a TableRow 

TableRow tr = new TableRowO ; 

//create a TableCell 

TableCell tc = new TableCell () ,- 

//add the text 
^ tc.addChild{new Text ( "Color : " ) ) ; 

//add the cell to the row 
2 tr .addChild(tc) ; 

2 //make a new cell 

~ tc = new TableCell (); 

j //add the text 

~ z tc . addChild (new Text (color) ) ; 

//add the cell to the row 

3 tr. addChild (tc) ; 

//add the row to the table 
J table. addChild { tr ) ; 

=s //continue this for each row. . . 

- tr = new TableRowO ; 

h tc = new TableCell (); 

tc . addChild (new Text ( "Username : " ) ) ; 

tr. addChild (tc) ; 

tc = new TableCell (); 

tc .addChild (new Text (usrName) ) ; 

tr .addChild(tc) ; 

table. addChild (tr) ; 

tr = new TableRowO ; 
tc = new TableCell ( ) ; 

//Show the password for this sample. Of course, this is not recommended... 
tc .addChild (new Text ("Password: ")); 
tr .addChild(tc) ; 

tc = new TableCellO; 

tc . addChild (new Text (password) ) ; 

tr .addChild(tc) ; 

table .addChild (tr) ; 

//add the table to the page's body 
body. addChild (table) ; 



//add the body to the page 
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page . addChi Id (body) ; 



//render the page 

String resultString = page . render <) ; 



return resultString; 



/ * * 

* This is a simple exception rendering method. 



* 



* ©param message the message to be presented to the user 
* 

* ©return the rendered HTML page deck 
*/ 

private String renderException (String message) 

{ 

//create the page 

HTMLTagDocument page = new HTMLTagDocument ( ) ; 

Body body = new Body ( ) ; 

//set the background color 

body .addAt tribute ( "bgcolor" , "#f f f f f f " ) ; 

body . addChild (new Text (message) ) ; 
body . addChild (new Break ( ) ) ; 

String resultString = body . render () ; 

return resultString; 
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import com. thinairapps . platform. connector . * ; 
import com . thinairapps - tag . html . * ; 
import com. thinairapps .platform. device . * ; 

import java.util.*; 
import j ava . io . * ; 



* 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved. 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE / 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF / 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

* The basis of this sample application is to demonstrate the "portal" example where there / 

is a 

* single log on and then the user can proceed to other "applications" within the portal. In/ 

this 

* case the user logs in and then is presented with a menu of 2 other applications. When the/ 

user 

* enters one of the applications it then checks to see if it has been configured yet, if it / 

has not 

3* it will then present the configuration fields, the user enters and proceeds, the / 

5 application then displays 

Jf* the information entered. At this time the user can either go back to the original z 
« application, where it will display 

~J* the data entered previously or proceed to the second app and the same process repeats. / 
If This demonstrates how a developer 

^* can develop numerous apps with a single log in. The main detail being the ability to pass/ 

6 the Session ID around and 

~4* use it for each application to store data (in this case the user ID and password) 
Q* This connector is the main connector that leads to the other "apps". It uses Sessions / 
and User Profiles. Sessions 

* are temporary while User Profile is stored and can be retrieved at a later time. 

3*/ 

^public class PortalConnector implements Connector 

a 

i = - ConnectorAccess myCA; 
J String appPath; 

//need to store the ConnectorAccess and ApplicationPath 

public void init (String name, String p, Properties iniProps, ConnectorAccess ca, / 
ApplicationLog al) 

myCA = ca; 
appPath = p; 



//this connector only supports HTML 
public String [] getDevicesO 

String [] devices = { " TA_HTML " } ; 
return devices ; 



public void handle (Properties reqProps, Device device, OutputStream out) throws / 
IOException 

String sid = null; 
String result = null; 
String firstTime; 
Hashtable cache - null; 



String login; 
String passwd; 
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//these variables are used to keep track of when a user enters and what screen should* 

be presented 
firstTime = reqProps - getProperty ( " f irstTime" ) ; 
sid = reqProps .getProperty ( "sid" ) ,- 
if (firstTime -= null) 
{ 

//If it is the firstTime then 
//create a new session 
result = generateLogin ( ) ; 

} 

else 

//It's not the first time, but I still haven't generated a Session ID yet 
if (sid == null) 

{ 

try 

{ 

//Create the session using ConnectorAccess 
sid = myCA. createSession ( ) ; 
//get the cache for this session 
cache = myCA. getSessionCache ( sid) ; 

} 

catch (Exception e) 

{ 

□ //Can pass any exception messages to the exception rendering method 

!? } 

^ //As long as I get the cache, then proceed to populate with data 

~4 if (cache != null) 

e { 

; | login = reqProps .getProperty ( "usr" ) ; 

^ passwd = reqProps .getProperty ( "pwd" ) ; 

^ cache .put ( "usr" , login) ; 

C cache .put ( "pwd" , passwd); 

} 

} 

^ //The values are stored in the cache, display the menu to the user 

result = generateMenu (sid) ; 



out .write (result .getBytes ( ) ) ,- 



} 



public String generateLogin ( ) 

{ 

//Generate the HTML for the User to Login 
HTMLTagDocument html Tag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ,- 

Paragraph pTag = new Paragraph () ; 

pTag . addChild(new Text ( "Welcome to the Portal") ) ,- 

pTag . addChild (new Break ( ) ) ; 

pTag . addChild (new Text ( " Please Login")); 

pTag . addChild (new Break ( ) ) ; 

bodyTag -addChild (pTag) ; 

Form formTag = new Form ("Login", appPath, "POST"); 

f ormTag . addFormElement (new Labeledlnput ( "usr" , "Username : " ) ) ; 

formTag . addChild (new Break ( ) ) ; 

PasswordField pwdlnput = new PasswordField ( "pwd" ) ; //create a password field 
formTag. addChild (new Text ( "Password : 11 ) ) ; //add a label 
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f ormTag . addFormEl erne nt (pwd Input ) ; //ad the password field 

f ormTag . addChild{new Break () ) ; 

formTag.addChild{new Hiddenlnput ( "f irstTime" , "Yes" ) ) ; 
formTag.addChild(new SubmitButton ("Submit")); 

bodyTag . addChild ( f ormTag) 

htmlTag.addChild(bodyTag) ; 

return htmlTag . render () ; 



public String generateMenu (String sid) 

{ 

//generate the Menu 

HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ,- 

Paragraph pTag = new Paragraph ( ) ; 

pTag . addChild (new Text ("Please select the application you woud like")); 
pTag .addChild (new Break () ) ; 

bodyTag . addCh i 1 d ( pTag ) ; 

Anchor anl = new Anchor ( "Applicationl " , " /portal/appl?sid= " + sid, new Text 
("Application 1")); 

Anchor an2 = new Anchor ( "Application2 " , " /portal/app2?sid= " + sid, new Text 

("Application 2") ) ; 
bodyTag . addChild (anl) ; 
bodyTag. addChild (new Break () ) ; 
bodyTag . addChild (an2 ) ; 
bodyTag .addChild (new Break () ) ; 



html Tag. addChild (bodyTag) ; 
return htmlTag . render () ; 
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* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved. 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 

* Here is just a class that has some properties and methods, the main thing to mention is 

that 

* it implements Serializable , this is required to store data in UserProfile 



public class ApplicationlUserData implements j ava . io . Serializable 



{ 



private String ssNum; 

private String password; 

private String host ; 

private String additionalParam; 

publ ic Appl icat ionlUserData ( ) 



ssNum- "Unknown" ; 
passwords "None" ; 
host= n n/a" ; 
additional Param= "n/a" 



If public ApplicationlUserData (String ssn, String pw, String ht, String ap) 

ssNum = ssn; 
password = pw; 
host = ht ; 

additionalParam = ap; 



public void setssNum (String ssn) 
ssNum = ssn; 

public void setPassword (String pw) 
password = pw; 

public void setHost (String ht) 
host = ht ; 

public void setAdditionalParam (String ap) 
additionalParam = ap; 

public String getssNumO 
return ssNum; 

public String getPassword ( ) 
return password; 



public String getHostO 
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return host; 

} 

public String getAddditionalParam ( ) 

{ 

return additional Pa ram; 

} 

} 
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import com. thinairapps . platform . connector . * ; 
import com. thinairapps . tag .html . * ; 
import com. thinairapps . platform . device . * ; 

import java.util.*; 
import j ava . io . * ; 

/ * * 
* 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved. 
* 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
* 

* This Connector is called from the main menu of the portal. It first checks to see if the 

session passed in is valid 

* Then it checks to see if the user is in User Profile, if their is an entry then display 

the data, if there isn't 

* then display the configuration field and have the user enter the data. There is a bit of 

a tricky part and the way 

* I've implemented is not the most robust way. The tricky part deals with if a user already^ 
has a User Profile, but from 

^* another application. In that case it needs to check if the data in User profile is ^ 
5? associated with this application 

^* in particular. I've marked the code where the logic is taking place 
4*/ 

ipublic class ApplicationlConnector implements Connector 

^ ConnectorAccess applCA; 

'"4 String applPath; 

Ti String applName; 

_ public void init (String appName , String appPath, Properties connectorProps , 
3 ConnectorAccess ca, ApplicationLog al) 

p { 

» applCA = ca; 

ff applPath = appPath; 

i "I applName = appName ; 

□ } 

■~~ public String [] getDevices { ) 

{ 

return new String [] { "TA_HTML" } ; 

} 

public void handle (Properties appProps, Device dev, OutputStream out) 

{ 

String sid; 
String usrName; 
String password; 
String result, - 
String dataEntered; 

boolean valid; 
boolean userExists; 
Hashtable cache = null; 

//first get the SID, in this case the only way that a user should enter this 
application is through the menu 

sid = appProps .getProperty ( "sid" ) ; 

//another variable to see where the user is 

dataEntered = appProps . getProperty ( "dataEntered" ) ; 
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//check to see if the session is valid, it might have timed out.... 
valid = applCA. sessionVal id (sid) ; 

if (valid) 
{ 

//extract user information 
//Now get the cache from the SID 
try 

cache = applCA. getSessionCache ( sid) ; 

} 

catch (Exception e) 

{ 

//catch NoSuchSessionException 

} 

//retrieve the username and password 
usrName = (String) cache . get ( "usr" ) ; 
password = (String) cache . get ( "pwd n ) ; 

//Here's the TRICKY part, now we go and look to see if there is data associated ^ 
with this 

//application in particular. The method userProf ileExists does not tell us whichwf 

application 
//(if any) there is data for. 

userExists = applCA . userProf ileExists (usrName) ,- 

ApplicationlUserData applUserEnteredData = null; 
try 

//Here is where we try to see if there is data associated with this * 
application 

applUserEnteredData = (ApplicationlUserData) applCA. getUserProf ileData (usrName 
, applName) ; 

} 

catch (Exception e) 

{ 

//catch NoSuchUserProf ileException 

} 

//Here we check 2 things 

//l)If the user does not exist, then it is his first time and display the 
configuration screen 

//2) Or he already exists, but the data is for another application, display the * 

configuration screen for htis application 
if ("userExists || applUserEnteredData == null) 

{ 

//check, to see if data for user has been entered 

//this needs to be passed twice, once to check if user exists, then check * 

again for entering data 
if (dataEntered != null) 

{ 

//store user data 

//instatiate ApplicaitonlUserData 

ApplicationlUserData applUserData = new ApplicationlUserData () ; 
//Set the variables 

applUserData . se t ssNum ( appProps . get Property ( " ssNum" ) ) ; 
applUserData . setPassword (appProps . getProperty ( "pwd" ) ) ; 
applUserData . setHost (appProps .getProperty ( "host " ) ) ,- 

applUserData . setAddit ionalParam (appProps .getProperty ( "addit ionalParam" ) ) ; 

//1st create the user profile 
try 

//Here's another check, if the user already exists, and we are here that * 
means 

//there was no data for this application, but we do not need to create 

another userprofile 
//so if the User does not exist, then create.... 
if ( "userExists) 
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applCA. createUserProf ile (usrName, password, applName) ; 

} 

//2nd now add the application data 

applCA. setUserProf ileData (usrName, applName, applUserData) ; 

} 

catch (Exception e) 

//catch exception for Prof ileAl ready Exists 
//catch exception for Prof ileStoreLockedException 

} 

//Some HTML to tell the user that the data has been stored 
HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ; 
Body bodyTag = new BodyO ; 

Paragraph pTag = new Paragraph ( ) ; 

pTag.addChild(new Text ( "Application 1 User Added")); 
pTag.addChild(new Break () ) ; 

pTag.addChild(new Text ("For User " + usrName) ) ; 
pTag . addChild(new Break () ) ; 
bodyTag .addChi Id (pTag) ; 

//View the data entered, incorporate the SID into the URL 
□ Anchor anl = new Anchor ("View Data", applPath + "?sid=" + sid, new Text ("View*' 

S Data" ) ) ; 

2 bodyTag . addChi Id (anl) ; 

U htmlTag.addChild (bodyTag) ; 

y try 

out.write( htmlTag . render (). getBytes ()) ; 

H ) 

\i catch (Exception e) 

//catch out exception 

} 

% ) 

~ else 

ri { . . 

3 //Else the user does not exist so display the configuration screen 
^ result = renderlnputUserDataScreen (sid) ; 

try 

{ 

out .write (result .getBytes ( ) ) ; 

} 

catch (Exception e) 

{ 

//catch IO excecption 

} 

} 

} 

else 

//if user exists and Application Data for this app exists that means that data * 

already is there 
//so display data to user 

HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ; 



Paragraph pTag = new Paragraph ( ) ; 

pTag.addChild(new Text ( "Application 1 Data")); 
pTag . addChi Id (new Break ()) ; 

pTag . addChi Id (new Text ("For User " + usrName)); 
pTag.addChild(new Break ( ) ) ; 
bodyTag . addChi Id (pTag) ; 
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bodyTag . addChild (new Text ( "Social Number: " + applUserEnteredData . kT 

getssNum( ) ) ) ; 
bodyTag .addChild (new Break { ) ) ; 

bodyTag .addChild (new Text { "Password: " + applUserEnteredData . get Password * 
< > ) ) ; 

bodyTag . addChild (new Break ( ) ) ; 

bodyTag. addChild (new Text ("Host: " + applUserEnteredData .getHost ())) ; 
bodyTag . addChild (new Break ( ) ) ; 

bodyTag . addChild (new Text ( "Additional Parameter: " + applUserEnteredData . / 

getAddditionalParam ( ) ) ) ; 
bodyTag . addChild (new Break ( ) ) ; 

bodyTag . addChild (new Text ("This data is now stored in UserProfile and can/ 
be retrieved at any time with the Login and Password<br>") ) ; 

Anchor anl = new Anchor { "Menu" , " /portal ?f irstTime=l&sid= " + sid, new / 
Text ("Return to Portal Menu") ) ; 

bodyTag . addChild ( anl ) ; 

html Tag . addChild (bodyTag) ; 

try 

{ 

out.write( htmlTag . render (). getBytes ()) ; 

} 

catch (Exception e) 

{ 

//catch out exception 

} 

} 

} 

else 

{ 

String result2 = "Sorry Session is not valid or Timed Out, please login again"; 

try 

{ 

out .write (result2 .getBytes () ) ; 

} 

catch (Exception e) 

{ 
} 

} 



} 

public String render InputUserDataScreen (String sid) 

{ 

HTMLTagDocument html Tag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag - new Paragraph ( ) ; 

pTag .addChild (new Text ( "Please configure Application 1")); 

pTag -addChild (new Break ( ) ) ; 

pTag. addChild (new Text ( "Enter Data")); 

pTag . addChild (new Break ( ) ) ; 

bodyTag. addChi Id (pTag) ; 

Form formTag = new Form ("UserData", applPath, "POST") ; 

formTag . addFormElement (new Labeledlnput ( " ssNum" , "Social Security Number: " ) ) ; 
formTag . addChild (new Break ( ) ) ; 

PasswordField pwdlnput = new PasswordField ( "pwd" ) ; 



formTag. addChild (new Text (" Password : ")); 
formTag . addFormElement (pwdlnput) ; 
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f ormTag . addChild (new Break ( ) ) ; 

f ormTag. addFormElement (new Labeledlnput ( "host " , "Host: ")); 
f ormTag. addChild (new Break 0 ) ; 

f ormTag .addFormElement (new Labeledlnput ( "additionalParam" , "Additional Parameter kT 
: " ) ) ; 

f ormTag .addChild (new Break ( ) ) ; 

f ormTag. addChild (new Hiddenlnput ( " sid" , sid) ) ; 

f ormTag. addChild (new Hiddenlnput ( "dataEntered" , "Yes") ) ; 

f ormTag. addChild (new SubmitButton ("Submit")); 

bodyTag . addChi Id ( f ormTag ) ; 

htmlTag . addChild (bodyTag) ; 

return htmlTag . render () ; 



} 
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catch (Exception e) 

{ 

/ / ca t ch NoSuchUser Prof i 1 eExcept ion 

if (luserExists || app2UserEnteredData == null) 
{ 

//check to see if data for user has been entered 

//this needs to be passed twice, once to check if user exists / then checks 

again for entering data 
if (dataEntered != null) 

{ 

//store user data 

//instatiate ApplicaitonlUserData 

Application2UserData app2UserData = new Application2UserData ( ) ; 
//Set the variables 

app2UserData . setPref erences (appProps .getProperty ( "preferences" ) ) ,- 
app2UserData. setAge ( Integer .parselnt (appProps .getProperty { "age" ) ) ) ; 



//1st create the user profile 
try 

{ 

if ( luserExists) 

{ 

app2CA. createUserProf ile (usrName , password, app2Name) ; 

} 

//2nd now add the application data 

app2CA. setUserProf ileData (usrName, app2Name, app2UserData) ; 

} 

catch (Exception e) 

{ 

//catch exception for Prof ileAl ready Exists 
//catch exception for Prof ileStoreLockedException 

} 



HTMLTagDocument html Tag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph ( ) ; 

pTag . addChild (new Text ( "Application 2 User Added" ) ) ; 
pTag . addChild (new Break ( ) ) ; 

pTag. addChild (new TextC'For User " + usrName)); 
pTag . addChild (new Break ( ) ) ; 
bodyTag . addChild (pTag) ; 

Anchor anl = new Anchor ( "View Data", app2Path + "?sid=" + sid, new ^ 

Text ( "View Data" ) ) ; 
bodyTag . addChild (anl) ; 
html Tag . addChild (bodyTag) ,- 
try 
{ 

out . write ( htmlTag . render ( ) . getBytes ( ) ) ,- 

} 

catch (Exception e) 

{ 

//catch out exception 

} 

} 

else 

{ 

result = renderlnputUserDataScreen (sid) ; 
try 

{ 

out . write ( result .getBytes ( ) ) ; 

} 

catch (Exception e) 

{ 
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//catch IO excecption 

} 

} 

} 

else 

//if user exists that means that data already is there 
//so display data to user 

HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph ( ) ; 

pTag. addChild (new Text ( "Application 2 Data")); 
pTag. addChild (new Break () ) ; 

pTag.addChild(new Text ("For User " + usrName) ) ; 
pTag . addChild (new Break ( ) ) ; 
bodyTag . addCh i 1 d ( pTag ) ; 

bodyTag. addChild (new Text (" Preferences : " + app2UserEnteredData . y? 

getPref erences ( ) ) ) ; 
bodyTag .addChild (new Break () ) ; 

bodyTag. addChild (new Text ( "Age : " + app2UserEnteredData .getAge ( ) ) ) ; 
bodyTag .addChild (new Break ( ) ) ; 

bodyTag .addChild (new Text ("This data is now stored in UserProfile and cantf 
be retrieved at any time with the Login and Password<br>") ) ; 
" s ™ Anchor anl = new Anchor ( "Menu" , " /portal ?f irstTime=l&sid= " + sid, new *r 

'^f Text ("Return to Portal Menu")); 

{J3 bodyTag. addChild (anl) ; 

htmlTag .addChild (bodyTag) ; 
f= try 

yJ out . write ( htmlTag . render ( ) . getBytes ( ) ) ; 

iyS catch (Exception e) 

{ 

1 //catch out exception 

} 



} 



} 

else 

{ 



String result2 = "Sorry Session is not valid or Timed Out, please login again"; 
try 

{ 

out .write (result2 .getBytes ( ) ) ; 
} 

catch (Exception e) 

{ 
} 



} 

public String renderlnputUserDataScreen (String sid) 
{ 

HTMLTagDocument htmlTag = new HTMLTagDocument ( ) 
Body bodyTag = new Body ( ) ; 



Paragraph pTag = new Paragraph ( ) ; 

pTag. addChild (new TextC'Please configure Application 1")); 

pTag. addChild (new Break ( ) ) ; 

pTag. addChild (new Text ("Enter Data")); 

pTag . addChild (new Break ( ) ) ; 

bodyTag . addCh i 1 d ( pTag ) ; 



C: \TASS\ . . \Portal\PortalApplication2\Application2Connector . java 



4 



Form formTag = new Form ("UserData", app2Path, "POST"); 

formTag.addFormElement (new Labeledlnput ( "preferences" , "Preferences: " ) ) ; 
formTag . addChild (new Break ( ) ) ; 

formTag.addFormElement (new Labeledlnput ( "age" , "Age: ")); 

formTag. addChild (new Break ( ) ) ; 

formTag .addChild (new Hiddenlnput ( " sid" , sid) ) ; 

formTag. addChild (new Hiddenlnput ( "dataEntered" , "Yes") ) ; 

formTag. addChild (new SubmitButton ("Submit")); 

bodyTag. addChild (formTag) ; 

htmlTag. addChild (bodyTag) ; 

return htmlTag . render ( ) ; 



} 
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/ * * 

* Here is just a class that has some properties and methods, the main thing to mention is * 

that 

* it implements Serializable, this is required to store data in UserProfile 
*/ 

public class Application2UserData implements j ava . io . Serializable 
{ 

private String preferences ; 
private int age; 

public Application2UserData ( ) 

preferences = "None"; 
age = 0 ; 



public Application2UserData (String p, int a) 

preferences = p; 
age = a ; 



public void setPref erences (String p) 
preferences = p; 



public void setAge(int a) 
age = a ; 



public String getPref erences ( ) 
return preferences; 



f=i public int getAgeO 
^ return age; 
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import com . thinai rapps . plat form . connector . * ; 
import com . thinairapps . tag . html . * ; 
import com . thinairapps . platform . device . * ; 

import java.util . * ; 
import j ava . io . * ; 

* This is the same as for Application 1, except different set of data for Application 2 
*/ 

public class Application2Connector implements Connector 
{ 

Connect or Access app2CA; 
String app2Path; 
String app2Name; 

public void init (String appName, String appPath, Properties connectorProps, \l 
ConnectorAccess ca, ApplicationLog al) 

{ 

app2CA = ca; 
app2Path = appPath; 
app2Name = appName; 

} 

public String [] getDevicesO 
=j return new String [] { " TA_HTML " } ; 

^ public void handle (Properties appProps, Device dev, OutputStream out) 

5 ~ String sid; 

String usrName; 
ii String password; 

y String result; 

^ String dataEntered ; 

boolean valid; 
^ boolean userExists; 

5 Hashtable cache = null ,- 

□ sid = appProps .getProperty ( "sid" ) ; 

l~ dataEntered = appProps .getProperty { "dataEntered" ) ; 

^ valid = app2CA. sessionValid (sid) ; 

if (valid) 
{ 

//extract user information 

try 

{ 

cache = app2CA.getSessionCache (sid) ; 

} 

catch (Exception e) 

{ 

//catch NoSuchSessionException 

} 

usrName = (String) cache . get ( "usr" ) ; 
password = (String) cache . get ( "pwd" ) ; 
//check to see if user exists 

userExists = app2CA. userProf ileExists (usrName) ; 
//if he doesn't then prompt user to fill in fields 
Application2UserData app2UserEnteredData = null; 
try 

app2UserEnteredData = (Application2UserData) app2CA. getUserProf ileData (usrName^ 
, app2Name) ; 

} 
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* Here is just a class that has some properties and methods, the main thing to mention is 

that 

* it implements Serializable , this is required to store data in UserProfile 
*/ 

public class ApplicationlUserData implements java . io . Serializable 



{ 



private String ssNum; 

private String password; 

private String host; 

private String additionalParam; 

public ApplicationlUserData ( ) 



s sNum= " Unknown " ; 
password^ "None" ; 
host="n/a" ,- 

additionalParam="n/a M ; 



public ApplicationlUserData (String ssn, String pw, String ht. String ap) 

ssNum = ssn; 
password = pw; 
host = ht ; 

additionalParam = ap; 



public void setssNum (String ssn) 
ssNum = ssn; 

public void setPassword (String pw) 
password = pw; 

public void setHost (String ht) 
host = ht ; 

public void setAdditionalParam (String ap) 
additionalParam = ap; 

public String getssNumO 
return ssNum; 

public String getPassword ( ) 
return password ; 

public String getHostO 
return host; 

public String getAdddit ionalParam ( ) 
return additionalParam; 
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import com. thinairapps . platform. connector . * ; 
import com . thinairapps - tag . html . * ,- 
import com. thinairapps. platform. device. *,- 

import j ava . ut i 1 . * ; 
import j ava . io . * ; 



* This Connector is called from the main menu of the portal. It first checks to see if the * 

session passed in is valid 

* Then it checks to see if the user is in User Profile, if their is an entry then display *r 

the data, if there isn't 

* then display the configuration field and have the user enter the data. There is a bit of 

a tricky part and the way 

* I've implemented is not the most robust way. The tricky part deals with if a user already^ 

has a User Profile, but from 

* another application. In that case it needs to check if the data in User profile is 

associated with this application 
" * in particular. I've marked the code where the logic is taking place 
*/ 

public class ApplicationlConnector implements Connector 

{ 

Connect or Access applCA; 
String applPath; 
==! String applName; 

y public void init (String appName, String appPath, Properties connectorProps , 
p ConnectorAccess ca, ApplicationLog al) 

4 { 

y~ applCA = ca; 

^ applPath = appPath; 

applName = appName; 

;J } 

^ public String [] getDevicesO 

3 return new String [] { " TA_HTML " } ; 

n > 

^ public void handle (Properties appProps, Device dev, OutputStream out) 

g String sid; 

"7 String usrName; 

™ String password; 

String result; 

String dataEntered; 

boolean valid; 
boolean userExists; 
Hashtable cache = null; 

//first get the SID, in this case the only way that a user should enter this 
application is through the menu 

sid = appProps .getProperty ( "sid" ) ,- 

//another variable to see where the user is 

dataEntered = appProps . get Property ( "dataEntered" ) ; 

//check to see if the session is valid, it might have timed out. . . . 
valid = applCA. sessionValid ( sid) ; 

if (valid) 
{ 

//extract user information 
//Now get the cache from the SID 
try 
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{ 

cache = applCA .getSessionCache (sid) ; 

} 

catch (Exception e) 

{ 

//catch NoSuchSessionException 

} 

//retrieve the username and password 
usrName = (String) cache .get ( "usr" ) ; 
password = (String) cache .get ( "pwd" ) ; 

//Here's the TRICKY part, now we go and look to see if there is data associated 
with this 

//application in particular. The method userProf ileExists does not tell us which/ 

application 
//(if any) there is data for. 

userExists = applCA. userProf ileExists (usrName) ,- 

ApplicationlUserData applUserEnteredData = null; 

try 

{ 

//Here is where we try to see if there is data associated with this / 
application 

applUserEnteredData = (ApplicationlUserData) applCA. getUserProf ileData (usrName/ 
, applName) ; 

. catch (Exception e) 

\U //catch NoSuchUserProf ileException 

H } 

g~ //Here we check 2 things 

;* 3 //l)If the user does not exist, then it is his first time and display the / 
^ configuration screen 

' : ~J //2) or he already exists, but the data is for another application, display the / 
ijj configuration screen for htis application 

if (luserExists || applUserEnteredData == null) 

L { 

\J //check to see if data for user has been entered 

if! //this needs to be passed twice, once to check if user exists, then check yt 

m again for entering data 

y if (dataEntered 1= null) 

1 1 stare user data 

//instatiate ApplicaitonlUserData 

ApplicationlUserData applUserData = new ApplicationlUserData () ; 
//Set the variables 

applUserData. setssNum (appProps . getProperty ( "ssNum" ) ) ; 
applUserData. setPassword (appProps .getProperty ( "pwd" ) ) ; 
applUserData . setHost (appProps .getProperty ( "host " ) ) ; 

applUserData . setAdditionalParam (appProps .getProperty ( "additionalParam" ) ) ,- 

//1st create the user profile 
try 

//Here's another check, if the user already exists, and we are here that / 
means 

//there was no data for this application, but we do not need to create 

another userprofile 
//so if the User does not exist, then create. . . . 
if ( ! userExists) 

{ 

applCA. createUserProf ile (usrName, password, applName); 

} 

//2nd now add the application data 

applCA. setUserProf ileData (usrName, applName, applUserData); 

} 

catch (Exception e) 

{ 

//catch exception for Prof ileAl ready Exists 



C: \TASS\ . . \Portal\PortalApplicationl\ApplicationlConnector . java 



3 



//catch exception for Prof ileStoreLockedException 

} 

//Some HTML to tell the user that the data has been stored 
HTMLTag Document html Tag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph ( ) ; 

pTag . addChild (new Text ( "Application 1 User Added")); 
pTag .addChild (new Break () ) ; 

pTag . addChild (new Text ("For User " + usrName) ) ; 
pTag . addChild ( new Break ( ) ) ; 
bodyTag .addChild (pTag) ; 

//View the data entered, incorporate the SID into the URL 

Anchor anl = new Anchor ( "View Data", applPath + "?sid=" + sid, new Text ( "Viewi^ 

Data") ) ; 
bodyTag . addChild (anl) ; 
htmlTag . addChild (bodyTag) ; 
try 

{ 

out. write ( htmlTag . render ( ) . getBytes ()) ; 

} 

catch (Exception e) 

{ 

//catch out exception 

} 



} 

else 

{ 

//Else the user does not exist so display the configuration screen 

result = renderlnputUserDataScreen (sid) ; 

try 

{ 

out . write ( result . getBytes ( ) ) ; 

} 

catch (Exception e) 

{ 

//catch 10 excecption 

} 

} 

} 

else 

//if user exists and Application Data for this app exists that means that data 

already is there 
//so display data to user 

{ 

HTMLTagDocument htmlTag = new HTMLTagDocument { ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph ( ) ; 

pTag . addChild (new Text { "Application 1 Data") ) ; 
pTag . addChi Id ( new Break ( ) ) ; 

pTag . addChild (new Text ("For User " •+ usrName) ) ; 
pTag . addChild (new Break () ) ; 
bodyTag . addChild (pTag) ,- 

bodyTag . addChild (new Text ( "Social Number: " + applUserEnteredData - 

getssNum ( ) ) ) ; 
bodyTag . addChild (new Break ( ) ) ; 

bodyTag . addChild (new Text ( "Password : " + applUserEnteredData . getPassword 
( ) ) ) ; 

bodyTag . addChild (new Break () ) ; 

bodyTag . addChild (new Text ("Host : " + applUserEnteredData . getHost ())) ; 
bodyTag . addChild (new Break ()) ; 
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bodyTag . addChild (new Text ( "Additional Parameter: " + applUserEnteredData.hr 

getAddditionalParamt ) ) ) ; 
bodyTag . addChild (new Break ( ) ) ; 

bodyTag . addChild (new Text ("This data is now stored in UserProfile and can/ 
be retrieved at any time with the Login and Password<br>" ) ) ; 

Anchor anl = new Anchor ( "Menu" , "/portal?f irstTime=l&sid- " + sid, new / 
Text ( "Return to Portal Menu" )); 

bodyTag .addChild (anl) ; 

html Tag .addChild (bodyTag) ; 

try 

{ 

out. write ( htmlTag . render ( ) . getBytes ( ) ) ; 

} 

catch (Exception e) 

{ 

//catch out exception 

} 

} 

} 

else 

{ 

String result2 = "Sorry Session is not valid or Timed Out, please login again"; 
try 

3 { 

jr= out .write (result2 .getBytes ( ) ) ; 

« } 

^- catch (Exception e) 

4 { 
p } 



.} 

public String renderlnputUserDataScreen (String sid) 
{ 

HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph () ; 

pTag .addChild (new Text ( "Please configure Application 1")); 

pTag . addChild (new Break ( ) ) ; 

pTag . addChild (new Text ("Enter Data")); 

pTag . addChild (new Break ( ) ) ; 

bodyTag . addChild (pTag) ; 

Form formTag = new Form ( "UserData" , applPath, "POST"); 

f ormTag . addFormElement (new Labeledlnput ( " ssNum" , "Social Security Number: " ) ) ; 
formTag . addChild (new Break ( ) ) ; 

PasswordField pwdlnput = new PasswordField ( "pwd" ) ; 

formTag . addChild (new Text ( "Password : ")); 
formTag . addFormElement (pwdlnput ) ; 
formTag . addChild (new Break () ) ; 

formTag . addFormElement (new Labeledlnput ( "host " , "Host : " ) ) ; 
formTag . addChild (new Break () ) ; 

formTag . addFormElement (new Labeledlnput ( "additionalParam" , "Additional Parameter 
: " ) ) ; 

formTag . addChild (new Break ( ) ) ; 

formTag . addChild (new Hiddenlnput ( " sid" , sid) ) ; 

formTag. addChild (new Hiddenlnput ( "dataEntered" , "Yes") ) ; 

formTag .addChild (new SubmitButton ("Submit")); 
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bodyTag . addChild (f ormTag) ; 
htmlTag.addChild(bodyTag) ; 
return htmlTag . render ( ) ; 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//core ThinAir Server API functionality 
import com. thinairapps .platform. * ; 
import com. thinairapps .platform. device .* ; 
import com. thinairapps .platform. connector. * ; 
import com. thinairapps . platform. exception. * ; 
import com. thinairapps . platform . provider . * ; 

//rendering packages used to build markup 
import com . thinairapps . tag . * ; 
import com. thinairapps . tag . wml . * ; 
//import com. thinairapps . tag . html . * ; 

// the groupware packages 

import thinairapps . groupware . api . * ; 

import thinairapps .groupware . api . actions . * ; 

import thinairapps . groupware . api . bounds . * ; 

import thinairapps .groupware . api . exception. * ; 

import java.util.*; 
^mport j ava . io . * ; 

fj2**This sample illustrates the use of the Customltem type to handle data in custom-created 
'••'.„ i* folders and databases. 

2* This sample renders WML. It prompts the user to choose one of two actions: add (create a ^ 
5 r 5 new 

fij* item in the specified folder) , or read (get the field names and values in the first item 
'■^j found 

within that folder, and display a group of them on the screen) . 

* 

e * The login data (provider name, host name, username, password) , the name of the template/ 
Pi form for 

the custom item folder, the name of the folder and (for a Lotus Domino item) the name of ^ 
*fj the 

Q* database, are all specified within the connector.ini file. 
* 

■ L-'* For a comprehensive reference of the Groupware Library see the ThinAir Groupware javadocs. 

H*/ 

public class CRMConnector implements Connector 

{ 

// The friendly name of this sample app 
protected String appName; 

//The path that needs to be appended to the server URL to access the app 
static String path; 

// Our access point to the services of ThinAir Server 
protected ConnectorAccess access; 

// The application log 

protected com. thinairapps . platform. connector . ApplicationLog log ; 

// The provider 

protected String provider; 

// The user's login data 

protected String host, userName, password; 

// The location of the custom item folder within the Groupware store. 
// This should not be a global variable in a real connector, 
protected String location; 

// The name of the form/template that this custom folder uses - 
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// this variable is not actually used in any of this connector's code; however, 
//it was included because it would be used by any real connector dealing with 
// CustomI terns, to add new items. See the comments within the addCustoml tern ( ) 
// method for details 
static String formName = null; 

protected String sessionld = null; 

static Device g_DEVICE; 

//Action constants 

static final String DISPLAY_ACTION - "display"; 
static final String ACT I ON__F I E LD = "action"; 
static final String LOGIN_ACTION = "login"; 
static final String CRE ATE_ACT I ON = "add"; 
static final String RE AD_ACT I ON = "read"; 
static final String VIEW_ACTION = "views"; 
static final String VIEW_BY_FIELD_ACTION = "view" ; 
static final String EDI T_ACT I ON = "edit"; 
static final String UPDATE_ACTION = "update" ; 

static final String VIEW_BY_STATUS= "ByStatus " ; 

static final String VIEW_BY_INDUSTRY^ "Bylndustry" ; 

static final String VI EW_BY_SALESCONTACT= "By Salescontact " ; 

□ static final String ELEMENT_NUMBER = "elemnum" ; 

0 

S //By Status Constants 

^ static final String STS_NEEDS_FIRST__CONTACT = "NFC" ; 

static final String STS_NEEDS_FOLL0WUP = "NFU" ; 
S static final String STS_NEEDS_CREDIT_APPROVAL = "NCA" ; 
sj static final String STS_NEEDS_TO_BE_INVOICED = "NTBI"; 
r l static final String STS_CREDIT_APPROVED « "CA"; 

static final String STS_INVOICE_SENT = "IS"; 
P static final String STS_CREDI T__DENI ED = "CD" ; 

static final String STS_DEAD_END = "DE" ; 

!f //By Industry Constants 

P static final String I_ADVERTI S ING = "ADV" ; 
3 static final String I_CONSULTING = "CON"; 
^ static final String I_ENTERTAINMENT = "ENT" ; 
'I! static final String I _F I NANCE = "FIN" ; 
«J static final String I _GOVERNMENT = "GOV" ; 

static final String I __HE ALTHC ARE = "HEA 

static final String I _MANUF ACTUR I NG = "MAN 

static final String I_RETAIL = "RET"; 

//By Sales Contact Constants 

static final String S C_M I KHAI L_BULGAKO V = "MB"; 
static final String S C_NE I L_D I AMOND = "ND" ; 
static final String SC_SAM_DONALDSON = "SD"; 
static final String SC_RICHARD_FEYNMAN = "RF" ; 
static final String SC_JOE_FRAZIER = "JF" ; 
static final String S C_ARTHUR_R I MB AUD = "AR" ; 
static final String S C_L E ON__T ROT S K Y = "LT" ; 
static final String SC_MICHELLE_YEOH = "MY"; 



ii . 



/ ★ * 

* initO is called by the ThinAirServer when the Connector is loaded. It provides the 

connector with 

* resources it needs to interact with the ThinAirServer. 

* For more information about the Connector interface, see the javadocs for the ThinAir * 

Server API 

* 

* ©param applicationName is a String derived from connector.ini. 

* ©param applicationPath is a String derived from connector.ini. We don't need this for/ 

this sample. 

* ©param connectorProps is a Properties list containing developer assigned 
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connector- specif ic properties. 
* ©param connectorAccess is our access point to the services provided by ThinAir Server. 
*/ 

public void init (String applicationName , String applicationPath, Properties 
connectorProps , 

ConnectorAccess connectorAccess, com . thinairapps . platform. connector . / 
ApplicationLog appLog) throws ConnectorlnitException 

{ 

this. path = applicationPath; 
this . appName = applicationName; 
access = connectorAccess; 
log = appLog; 

// the two strings from connector.ini that we'll use to create the official 
// "location" string. database is for Domino only 
String folder, database; 

// get provider name, as well as all login data, location of the custom folder, and 
// the name of the form/template being used, from the properties list (connector.ini) 
// Provider has to be either Exchange or Domino 
provider = connectorProps .getProperty (" Provider ") ; 

if (provider . length ( ) == 0) throw new ConnectorlnitException (i!No Provider entry in 
connector.ini") ; 

3 host = connectorProps .getProperty ( "Host ") ; 

p if (host . length ( ) == 0) throw new ConnectorlnitException ( "No Host entry in connector./ 

2 ini"); 

^ userName = connectorProps .getProperty ( "UserName" ) ; 

P if (userName . length ( ) == 0) throw new ConnectorlnitExcept ion ( "No UserName entry in / 
\\ connector.ini") ; 

fj? password = connectorProps .getProperty ( "Password" ) ; 

|3 if (password. length ( ) == 0) throw new ConnectorlnitException ( "No Password entry in / 
connector . ini " ) ; 

r? folder = connectorProps .getProperty ( "Folder" ) ; 

P if (folder . length ( ) == 0) throw new ConnectorlnitExcept ion ( "No Folder entry in ur 

3 connector.ini"); 

L ! database = connectorProps . getProperty { "Database ") ; 

□ // no exception thrown if user didn't include the name of the database - this may or 

^ may 

// not be a necessity for the groupware store being accessed. In the case of the 
groupware 

// providers that come with the ThinAir Server, the Domino provider requires one, / 

while the 
// Exchange provider doesn't 

// now, set the location string - if no database name was included, then location 
// will just be equal to the folder name 
if (database . length ( ) == 0) 
{ 

location = folder; 

} 

else 

{ 

// a database name was included; since we have only a single String to represent 
// the location within the eventual data request, how do we get both the folder 
// and the database name into this one String? Thankfully, there's a utility in 
// the Customltem class that takes care of it for us 

location = CustomI tern . LocNameUtils . createLocat ionString (database, folder); 

} 

formName = connectorProps . getProperty (" FormName ") ; 

//no exception thrown if user didn't include the name of the folder's form/ template ; 
// a Customltem connector can function without it, although not as well 
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/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used * 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile 1 s getName ( ) method. 
* 

* For more details about device detection and handling see the DeviceDetective sample / 

connector and the 

* ThinAir Server Developer Guide. 
* 

* ©return an array of Strings representing the friendly names of the devices this 

Connector supports. 

*/ 

public String [] getDevicesO 

String devices [] = {WAPDev ice Prof ile .NAME, HTMLDeviceProf ile .NAME, PalmVI IDeviceProf ile 
.NAME, OmniSkyDeviceProf ile .NAME} ; 

zf return devices; 

P. > 



/**The handle method implements the core logic of a Connector. It takes an incoming *r 
request from a 

* particular device, and returns an appropriate response. This method is called whenever/ 

the server 

* receives a request from a type of device that the Connector indicates it supports, 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of 

the Connector 

* to interpret the request and generate an appropriate response. 
* 

* The server will pass a Device object containing as much information as possible into 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed / 

information 

* on the capabilities of the particular device making the request. 
* 

* ©param props a set of name value pairs corresponding to the HTTP request parameters \£ 

from the device. 

* ©param device a Device object created in the image of the actual device making this 

request . 

* ©param result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle { Properties props, Device device, OutputStream result) throws / 
IOException 

{ 

String resultString = null; 

//Set the device equal to the global variable for device 
CRMConnector ,g_DEVTCE = device ; 

//The cache for this session 
Hashtable cache = null; 

//get the 'action' parameter from the request. This is an HTTP param we define to / 

determine what action 
//to take when we get a request. 

String action = props . get Property (ACTION_FIELD) ; 
String view = props . get Proper ty (ELEMENT_NUMBER) ; 
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try 

{ 



if (action == null) 

// if this is the first hit (or any request for the main deck) . . . 
if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renders tart Screen () ; 

else 

resultString = CRMHTMLRenderer . renderStartScreen ( ) ; 

//If all the elements on the form have been filled out, then display it 
else if (action. equals (DISPLAY_ACTION) ) 

{ 

addCustomltem ( location, sessionld, props) ; 
if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderMes sage ( "The form has been 
completed" ) ; 

else 

resultString = CRMHTMLRenderer . renderMes sage ( "The form has been 
completed" ) ; 

} 

} 

else if (action. equals (LOGIN_ACTION) ) 

sessionld = loginUser (provider , host, userName, password); 
if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderOptionMenu () ; 

else 

resultString - CRMHTMLRenderer . renderOptionMenu () ; 

} 

else 
{ 

if (action. equals <CREATE_ACTION) ) 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . render Input Form () ; 

else 

resultString = CRMHTMLRenderer . render Input Form () ; 

} 

else if (action. equals (VIEW_ACTION) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderAvailableViews ( ) ; 

else 

resultString = CRMHTMLRenderer . renderAvailableViews () ; 

} . . 

//One must view an item before they edit it, so we set certain important 

variables in 
//the view item section 
else if (action. equals (EDIT_ACTION) ) 

String editViewParam = props .get Property ( "editPrm" ) ; 

//From the URL, determine which element they want to see.. 
Integer prelimNumber = new Integer (0); 
int elementNumber ; 

elementNumber = (prelimNumber . parselnt (editViewParam) ) 

//Get the cache for this session 

cache = access .getSessionCache (sessionld) ; 

//Retrieve the Store Items that we've already placed into the cache 
//A Storeltems is a Vector 

Storeltems customltems = { (Storeltems) cache .get ( "storeitems" )) ; 
//Retrieve the particular item that we want 

Customltem item = ( (Customltem) (customltems . elementAt (elementNumber) )) ; 
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//Also get the message ID 

Storeltem storeltem = ( (Storel tern) (customl terns . elementAt i 

(element Number) ) ) ; 
String messagelD - storeltem .getID () ; 

//Render the Item 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . edit Item ( item, messagelD) ; 

else 

resultString = CRMHTMLRenderer . edit I tern ( item, me ssagelD) ; 

} 

else if (action. equals <UPDATE_ACTION) ) 
{ 

//Update the Item 

updateCustoml tern (location, sessionld, props); . 

//Render the message 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderMes sage (" Item has been updated") ; 

else 

resultString = CRMHTMLRenderer . renderMes sage ( " Item has been i 
updated" ) ; 

} 

else if (action. equals (VIEW_BY_STATUS) ) 

:0 Storeltems customltems = getCustomltems (location, sessionld); 

^ //Get the cache for this session 

jf cache = access . getSessionCache ( sessionld) ; 

\ll //Put the returned Storeltems into the cache 

'.,'Ji cache . put ( " s toreitems " , customltems ) ; 

iiU //render the fields of this object 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderView (customl terns , 
i™ VIEW_BY_STATUS) ; 

else 

□ resultString = CRMHTMLRenderer . renderView (customltems , 
jfs VIEW_BY_STATUS) ; 

□ else if (action. equals <VIEW_BY_INDUSTRY) ) 
U { 

Storeltems customltems = getCustomltems ( location, sessionld); 

//Get the cache for this session 

cache = access . getSessionCache (sessionld) ; 

//Put the returned Storeltems into the cache 
cache . put ( " storeitems" , customltems ) ; 

//render the fields of this object 
if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderView (customltems , 
VIEW_BY_INDUSTRY) ; 

else 

resultString = CRMHTMLRenderer . renderView (customl terns , 
VIEW_BY_INDUSTRY) ; 

else if (action. equals ( VI EW_BY_S ALES CONTACT) ) 

Storeltems customltems = getCustomltems ( location, sessionld) ; 

//Get the cache for this session 

cache = access . getSessionCache ( sessionld) ; 

//Put the returned Storeltems into the cache 
cache . put ( " storeitems" , customltems ) ; 
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//render the fields of this object 
if (device instanceof WAPDevice) 

resultstring = CRMWMLRenderer . renderView (customl terns , 
VIEW_BY_SALESCONTACT) ; 

else 

resultstring = CRMHTMLRenderer . renderView (customl t ems , 
VIEW_BY_SALESCONTACT) ; 

} 

//Determine what Customer Status view the user selected 

else if (action. equals ( "NFC" ) ) 

{ 

if (device instanceof WAPDevice) 

resultstring = CRMWMLRenderer .viewByField ( "Needs First Contact", 
access, sessionld) ,- 

else 

resultstring = CRMHTMLRenderer . viewByField ( "Needs First Contact 1 ', 
access, sessionld) 

} 

else if (action. equals ( "NFU" ) ) 
{ 

if (device instanceof WAPDevice) 

resultstring = CRMWMLRenderer .viewByField ( "Ne^ds Follow-Up" , access, * 
sessionld) ,- 

else 

resultstring = CRMHTMLRenderer . viewByField ( "Needs Follow-Up", access 
, sessionld) ; 

} 

else if (action. equals ( "NCA" ) ) 

{ 

if (device instanceof WAPDevice) 

resultstring = CRMWMLRenderer .viewByField ( "Needs Credit Approval", 
access, sessionld) ; 

else 

resultstring = CRMHTMLRenderer . viewByField ( "Needs Credit Approval", wT 
access, sessionld) ; 

} 

else if (action.equalsC'NTBI") ) 
{ • 

if (device instanceof WAPDevice) 

resultstring = CRMWMLRenderer .viewByField ( "Needs to be Invoiced", 
access, sessionld); 

else 

resultstring = CRMHTMLRenderer . viewByField ( "Needs to be Invoiced", 
access, sessionld) ; 

} 

else if (action.equalsC'CA") ) 
{ 

if (device instanceof WAPDevice) 

resultstring = CRMWMLRenderer . viewByField ( "Credit Approved", access, 
sessionld) ; 

else 

resultstring = CRMHTMLRenderer . viewByField ( "Credit Approved", access 
, sessionld) ; 

} 

else if (action. equals ("IS" ) ) 

{ 

if (device instanceof WAPDevice) 

resultstring = CRMWMLRenderer .viewByField (" Invoice Sent", access, ^ 
sessionld) ; 

else 

resultstring = CRMHTMLRenderer . viewByField (" Invoice Sent", access, 
sessionld) ; 

} 

else if (action . equals ( "CD" ) ) 

{ 

if (device instanceof WAPDevice) 

resultstring = CRMWMLRenderer .viewByField ( "Credit Denied", access, * 
sessionld) ; 
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else 

resultString = CRMHTMLRenderer .viewByField ( "Credit Denied", access, 
sessionld) ; 

} 

else if (action . equals ( "DE" ) ) 

{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Dead End", access, 
sessionld) ; 

else 

resultString = CRMHTMLRenderer . viewByField ( "Dead End", access, 
sessionld) ; 

} 

//Determine what Industry field the Customer selected 
else if (action. equals ( "ADV" ) ) 

{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Advertising" , access, 
sessionld) ; 

else 

resultString = CRMHTMLRenderer .viewByField ( "Advertising" , access, \£ 
sessionld) ,- 

} 

else if (action. equals ( "CON" ) ) 
{ 

J if (device instanceof WAPDevice) 

□ resultString = CRMWMLRenderer . viewByField ( "Consulting" , access, * 

fi sessionld) ; 

Z else 

^ resultString = CRMHTMLRenderer .viewByField ( "Consulting" , access, 

•~ sessionld) ; 

J } 

1 else if (action. equals ( "ENT") ) 

1 { 

y if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Entertainment " , access, 
«s sessionld) ; 

Z else 

H resultString = CRMHTMLRenderer .viewByField ( "Entertainment " , access, 

1 sessionld) ; 

s } 

^ else if (action. equals ("FIN") ) 

{ 

£ if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Finance" , access, \£ 
sessionld) ,- 

else 

resultString = CRMHTMLRenderer .viewByField (" Finance H , access, * 
sessionld) ; 

} 

else if (action. equals ("GOV") ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Government " , access, 
sessionld) ,- 

else 

resultString = CRMHTMLRenderer . viewByField ( "Government " , access, * 
sessionld) ; 

} 

else if (action. equals ("HEA") ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( "Healthcare " , access, ^ 
sessionld) ; 

else 

resultString = CRMHTMLRenderer . viewByField ( "Healthcare" , access, 
sessionld) ; 

} 

else if (action. equals ( "MAN" ) ) 
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{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( "Manufacturing" , access, * 
sessionld) ; 

else 

resultString - CRMHTMLRenderer . viewByField ( "Manufacturing " , access, * 
sessionld) ; 

} 

else if (action . equals ( "RET" ) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( "Retail " , access, 
sessionld) ; 

else 

resultString = CRMHTMLRenderer . viewByField ( "Retail " , access, 
sessionld) ; 

} 

//Determine what Sales Contact Field the Customer selected 
else if (action . equals ( "AR" ) ) 

{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( 11 Arthur Rimbaud", access, *r 
sessionld) ; 

else 

resultString = CRMHTMLRenderer . viewByField ( "Arthur Rimbaud", access, ^ 
if sessionld) ; 

3 } 

0 else if (action. equals ( "JF") ) 

.1 { 

j: if (device instanceof WAPDevice) 

\= resultString = CRMWMLRenderer .viewByField ( "Joe Frazier" , access, 

J sessionld) ,- 

: J else 

"t resultString = CRMHTMLRenderer -viewByField ( "Joe Frazier", access, * 

^ sessionld) ; 

} 

^ else if (action . equals ( "LT" ) ) 

1 { 

^ if (device instanceof WAPDevice) 

3 resultString = CRMWMLRenderer . viewByField ( "Leon Trotsky", access, * 

p= sessionld) ; 

^ else 

& resultString = CRMHTMLRenderer .viewByField ( "Leon Trotsky", access, ^ 

& sessionld) ; 

} 

else if (action . equals ( "MY" ) ) 

{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( "Michelle Yeoh" , access, * 
sessionld) ; 

else 

resultString = CRMHTMLRenderer . viewByField ( "Michel le Yeoh", access, 
sessionld) ; 

} 

else if (action . equals ( "MB" ) ) 

{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( "Mikhail Bulgakov", access * 
, sessionld) ,- 

else 

resultString = CRMHTMLRenderer . viewByField ( "Mikhail Bulgakov", access^ 
, sessionld) ; 

} 

else if (action . equals ( "ND" ) ) 

{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( "Neil Diamond", access, \£ 
sessionld) ; 

else 
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resultString = CRMHTMLRenderer . viewByField { "Neil Diamond", access, 
sessionld) ; 

} 

else if (action. equals ("RF") ) 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( "Richard Feynman" , access, 
sessionld) ; 

else 

resultString = CRMHTMLRenderer . viewByField ( "Richard Feynman", access * 
, sessionld) ; 

} 

else if (action. equals ( "SD" ) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Sam Donaldson", access, * 
sessionld) ; 

else 

resultString = CRMHTMLRenderer . viewByField ( "Sam Donaldson", access, 
sessionld) ; 

//Call the method that renders the fields of the selected item 
else if (action. equals (CRMConnector . VIEW_BY_FIELD_ACTION) ) 

^ Integer prelimNumber = new Integer (0) ; 

~f int elementNumber; 

y elementNumber = (prelimNumber . parselnt (view) ) ; 

H= //Get the cache for this session 

2 cache = access .getSessionCache ( sessionld) ; 

sj //Keep a reference to the item that the user is viewing in case we want * 
i.3 to edit 

■1 //it later 

U String itemKey= " ItemViewed" ; 

cache .put (itemKey, view) ; 

f? //Retrieve the Store Items that we've already placed into the cache 

lj //A Storeltem is a Vector 

□ Storeltems customltems = ( (Storeltems) cache .get ( "storeltems" )) ; 

11 //Retrieve the particular item that we want 

J Customltem item = ( (CustomI tern) (customltems . element At (elementNumber ))) ,- 

//Render the Item 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderCustoml temFi elds ( item, access, 
sessionld) ; 

else 

resultString = CRMHTMLRenderer . renderCustoml temFields ( item, access, 
sessionld) ; 

} 

} 

} 

catch (Exception e) 

{ 

e . printStackTrace ( ) ; 

// Here, we employ a primitive solution of simply displaying the error message \i 
and providing a link 

// back to the welcome screen; a larger app would handle each error separately * 

and navigate the 
// user accordingly 
if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderMessage ( e . getMessage ()) ; 

else 

resultString = CRMHTMLRenderer . renderMessage (e . getMessage ()) ; 

} 

// in this example we logged on, performed a simple action, then logged off again. A *r 
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more 

// complete app might hold the session open between requests, and cache the retrieved 
// Storeltems in the session cache, using this to feed item bodies out to the client 
// without going to the provider each time 
byte[] resultBytes = resultString . getBytes ( ) ; 
result -write (resultBytes) ; 



/**loginUser ( ) logs in the user to a groupware store using the specified login data 
* 

* ©param providerName the name of the provider being used to access the message store. 

* ©param host the IP or server name of the message store. 

* ©param userName the user name of the account being logged onto. 

* ©param password the password for this user. 

* ©return a providerSessionld if success; otherwise an error will be thrown. 
*/ 

protected String loginUser (String providerName, String host, String userName, 

String password) throws Exception 

{ 

String SID = null; 
try 

// Create a new Session with the specified provider and returns a unique Session kT 
ID. 

SID = access . createProviderSession (providerName); 

// Get the providerProxy associated with the session we just created, 
// this is what is used to interact with the Provider 
StoreProviderProxy spLite = access . getStoreProvider (SID) ,- 

// Create a StoreProviderLogin object, this defines the action the provider will 
execute 

StoreProviderLogin login = new StoreProviderLogin (userName, password, host) ; 

// use the providerProxy to login. The provider returns the items it supports 
Support edit ems supports = spLite . connectUser (login); 

// check to make sure that this provider handles Customltem objects 

boolean support sCust I terns = false; 

Enumeration support edEnum = supports .get I terns () ; 

while ( supportedEnum . hasMoreElements ( ) ) 

Supportedltem curltem = (Supportedltem) supportedEnum . nextElement () ; 
if (curltem. getType () == ItemTypes . CUSTOM_ITEM) 
supportsCustl terns = true; 

} 

// if it doesn't handle Customltem objects, throw an exception 
if (! supportsCustl terns) 

throw new Exception ( "Specif ied provider ( " + providerName + ") does not ^ 
support Customltem handling"); 

} 

catch (NoSuchProviderException e) 

throw new Except ion ( "No Provider named " + providerName + " was loaded by the 
ThinAir Server"); 

} 

return SID; 



/**getCustomItems ( ) retrieves items from a groupware location, and returns a 
* Customltems object containing all its information 
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* ©param location The location in the groupware store being accessed 

* ©param SID The session ID for the user's connection to the groupware store 

* ©return a Customltem representing the first item in the folder 
*/ 

protected Storeltems getCustoml terns (String location, String SID) throws Exception 

{ - 

String resultString ; 

ItemRequest iReq = new ItemRequest (); 
iReq. itemType = ItemTypes . CUSTOM_ITEM; 
iReq . itemLocation = location; 

//Use -1 to specify no maximum limit 
iReq .max = -1; 
iReq.startID = null; 
iReq -bounds = null; 

UserDataRequest udReq = new UserDataRequest ( ) ; 
udReq. requests = new ItemRequest [1] ; 
udReq. requests [0] = iReq; 

UserData uData = access - getStoreProvider (SID) . getUserData (udReq) ; 
ItemRequestResponse irr = uData . responses [0] ; 
=* Storeltems customltems = irr. items ,- 

*f return customltems; 

3 } 



/**addCustomItem( ) adds an item to a groupware location containing custom- 

* defined items 
* 

* ©param location The location in the groupware store being accessed 

* ©param SID The session ID for the user's connection to the groupware store 
*/ 

protected void addCustomltem (String location, String SID, Properties props) throws 
Exception 

{ 

try { 

//Create a custom item 

//String formName = n I PM . Contact . Sample" ,- 
//String formName = "Sample"; 
/ / From Connector . ini 

//String formName - connectorProps . getProperty ( "FormName" ) ; 
//String providerName - "Domino" ; 

Customltem custltem = new Customltem ( ItemTypes . CONTACT, formName); 

//Example of how to set the standard fields of a custom Item 
//Each Customltem has a Standardltem included within it 
//Contact testContact = new Contact () ; 
//custltem. setStandardltem (testContact) ; 
//testContact . setFullName ( "Rudy Guliani" ) ; 

//Set the time 

Calendar cal = Calendar .getlnstance () ; 

cal . setTime (new Date ( ) ) ; 

Date todayTime = cal . getTime ( ) ; 

String timeString = todayTime . toString () ; 

custltem. addField ( "ItemCreated" 1 , timeString); 

//If its a Domino Provider, then set the "Form" field to the form name 
//Future iterations of the Domino Provider will do this automatically 
if (provider . equals ( "Domino" ) ) 

{ 

custltem. addField ( " Form" , formName) ; 

} 
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//Set the fields of that item 

custItem.addField( ,, CustomerName ,, , props .getProperty ( "cstnm" ) ) ,- 
custltem. addFieldC'Position" , props .getProperty ( "psn" ) ) ; 
custItem.addField("CompanyName n , props .getProperty ( "cnm" ) ) ,- 

//Industry 

String industry = props .getProperty ( " industry ") ; 

String [] industryURLParams = {"a", "b", "c", "d", "e" , " f " , "g" , "h" } ; 

String [3 industries * 
= {"Advertising", "Consulting", "Entertainment", "Finance", "Government", "Healthcare " ^ 
, "Manufacturing" , "Retail" } ; 

int i ; 

for (i = 0; i < 8; i++) 

if (industry . equals (industryURLParams [i] ) ) 

custl tern. addField(" Industry " , industries [i] ) ; 
break ; 

} 

} 

«=. //Sales Contact 

^ String salescontact = props .getProperty ( "sc" ) ; 

0 String [] salesContactURLParams = {"a", "b", «c" , "d% "e" , "f " , "g" , "h" } ; 

O String [] salescontacts = {"Mikhail Bulgakov" , "Neil Diamond" , "Sam Donaldson" , "Richard * 

'J* Feynman" , " Joe Frazier" , "Arthur Rimbaud" , "Leon Trotsky" , "Michelle Yeoh" } ; 

= 0; i < 8; i++) 

(salescontact .equals (salesContactURLParams [i] ) ) 

custItem.addField( "Salescontact" , salescontacts [i] ) ; 
break ; 



^ //Account Number 

f| custItem.addField("AccountNumber" , props .getProperty ( "an" ) ) ; 

*f //Customer Status 

^ String customerStatus = props .getProperty ( "cust status" ) ; 

String [] customerStatusURLParams = {"a", "b", "c", "d" , "e" , "f " , »g" , "h" } ; 

String [] customerStatusVals = {"Needs First Contact " , "Needs Follow-Up" , "Needs Credit 

Approval" , "Needs to be Invoiced" , "Credit Approved" ," Invoice Sent ", "Credit *r 

Denied" , "Dead End" } ; 

= 0 ; i < 8 ; i++) 

(customerStatus . equals (customerStatusURLParams [i] ) ) 

custItem.addField( "CustomerStatus" , customerStatusVals [i] ) ; 
break ; 



// set the location of the new item to be the user- specif ied location 
custltem. setLocationlnStore (location) ; 

StoreProviderProxy spProxy = access . getStoreProvider (SID) ,- 

AddNewGroupwareltem addAction = new AddNewGroupwarel tern (custltem) ; 

spProxy . doUserDataAction (addAction) ; 
return; 

catch (Exception e) 



for (i 
{ 

if 
{ 



} 

} 



for (i 
{ 

if 
{ 



} 

} 
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{ 

System. out -println ("Error adding the item: " + e) ; 

} 

} 



/**addCustomItem ( ) adds an item to a groupware location containing custom- 

* defined items 
* 

* ©param location The location in the groupware store being accessed 

* ©param SID The session ID for the user's connection to the groupware store 

* ©param props The properties object containing the request 
*/ 

protected void updateCustoml tern (String location, String SID, Properties props) throws 
Exception 

{ 

try 

{ 

//Create a custom item 

//String formName = " I PM. Contact . Sample" ; 
//From Connector.ini 

String formName = props - get Proper ty ( "FormName ") ; 
//Get the messagelD 

String messagelD = props . getProperty ( "MessagelD" ) ,- 

//Create the new Customltem object. We're using it only as a container. 
Customltem custltemContainer = new Customltem ( I temTypes . CONTACT, formName) ; 



//Set the fields of that item 

custltemContainer- addField ( "CustomerName" , props .getProperty ( "cstnm" ) ) ; 
custltemContainer. addField( "Position", props .getProperty ( "psn" ) ) ; 
custltemContainer .addField ( " CompanyName " , props .getProperty ( "cnm" ) ) ; 

//Industry 

String industry = props . getProperty (" industry" ) ; 

String [] industryURLParams = {"a", "b" , "c", "d", "e" , H f " , n g" , "h" } ; 

String [] industries * 
« { "Advertising" , "Consulting" , "Entertainment" , "Finance" , "Government" , "Healthcare" 
, "Manufacturing" , "Retail" } ; 

int i ; 

for (i = 0; i < 8; i++) 

{ 

if (industry .equals (industryURLParams [i] ) ) 
{ 

custltemContainer .addField (" Industry" , industries [i] ) ; 
break ; 

} 

} 

//Sales Contact 

String salescontact = props .getProperty {" sc ") ; 

String [] salesContactURLParams = {"a", "b", "c", "d", "e" , "f " , "g" , "h" } ; 
String [] salescontacts = {"Mikhail Bulgakov" , "Neil Diamond" , "Sam Donaldson" , "Richard 
Feynman" , "Joe Frazier" , "Arthur Rimbaud" , "Leon Trotsky" , "Michelle Yeoh" } ; 

for (i = 0 ; i < 8 ; i++) 

if (salescontact . equals ( salesContactURLParams [i] ) ) 

custltemContainer .addField ( "Salescontact" , salescontacts [i] ) ; 
break ; 

} 

} 
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/ /Account Number 

custltemContainer .addField{ "AccountNumber" , props - get Property ( "an" ) ) ; 
//Customer Status 

String customerStatus = props .getProperty ( "custstatus ") ; 

String [] customerStatusURLParams = {"a", "b" , "c", "d" , "e" , "f » , "g" , "h" } ; 

String[] customerStatusVals = {"Needs First Contact", "Needs Follow-Up" , "Needs Credit 

Approval" , "Needs to be Invoiced" , "Credit Approved" , " Invoice Sent " , "Credit 

Denied" , "Dead End" } ; 

for (i = 0; i < 8; i++) 

if (customerStatus . equals (customerStatusURLParams [i] ) ) 

{ 

custltemContainer .addField( "CustomerStatus" , customerStatusVals [i] ) ; 
break; 

} 

} 

//New Contact object - this will be Customltem's standard item 
Contact actualContact - new Contact () ; 
custltemContainer . setStandardltem (actualContact) ; 

■~ // set the location of the new item to be the user-specified location 

^ custltemContainer . setLocationlnStore (location) ; 

jp StoreProviderProxy spProxy = access . getStoreProvider (SID) ; 

~f //AddNewGroupwareltem addAction = new AddNewGroupwareltem (custltem) ; 

// spProxy . doUserDataAct ion (addAction) ; 
d spProxy .doUserDa taAct ion (new updateGroupwarel tern (messagelD, location, ^ 

•~J custltemContainer) ) ; 

n } 

^ catch (Exception e) 

{ 

3 System. out .println ("Error updating the item"); 

ft > 

11 return ; 

j } 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//core ThinAir Server API functionality 
import com. thinairapps .platform. * ; 
import com. thinairapps . platform. device . * ; 
import com. thinairapps . platform. connector . * ; 
import com. thinairapps . platform. exception. * ; 
import com. thinairapps .plat form. provider .* ; 

//ThinAir Tag Libraries imports 
import com. thinairapps . tag .* ; 
import com. thinairapps . tag . html . * / 

// the groupware packages 

import thinairapps . groupware . api . * ; * 
import thinairapps .groupware .api .actions . * ; 
import thinairapps . groupware . api . bounds . * ; 
import thinairapps .groupware .api . exception . * ; 

//Standard Java imports 
.import java.util.*; 



"2* This utility class renders output as HTML for a variety of devices 
h*/ 

icjlass CRMHTMLRenderer 

-\ 

.2 /**This method renders a deck containing a welcome card 

jy * 

* ©return the rendered deck. 

□ */ 

™ static String renderStartScreen ( ) 

il { 

□ HTMLTagDocument doc = new HTMLTagDocument <) ; 

S com. thinairapps.tag.html .Head head = new com . thinairapps . tag . html . Head () ; 

fj if (CRMConnector .g__DEVICE instanceof PalmVIIDevice | | CRMConnector .g_DEVICE 

=? instanceof OmniSkyDevice) 

Meta meta = new Meta ( "name" , "PalmComputingPlatf orm" , "true") ; 
head.addChild (meta) ; 

com. thinairapps .tag .html .Bold bold = new com. thinairapps . tag .html . Bold ( "Sample CRM 

Connector" ) ; 
head . addChild (bold) ; 
doc . setHead (head) ; 

Body body = new Body ( ) ; 

com. thinairapps . tag . html . Paragraph para = new com . thinairapps . tag . html . Paragraph () ; 
body .addChild (para) ; 

String href = CRMConnector . path + "? M + CRMConnector .ACT I ON_F I ELD +"=."+ ^ 

CRMConnector . LOGIN_ACTION; 
com. thinairapps. tag. html. Anchor anl = new com . thinairapps . tag . html .Anchor ( "Start " , * 

href, new com . thinairapps . tag . html . Text (" Login" )) ; 



body . addChild (anl) ; 

body . addChild (new com. thinairapps . tag . html .Break () ) ; 
doc . set Body (body) ; 



String resultString = doc . render () ; 
return resultString; 
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/** 

* This method renders a deck with a card that lets the user specify which action to take 

* ©return the rendered deck. 
*/ 

static String renderOptionMenu ( ) 

^ HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps. tag .html .Head head = new com. thinairapps . tag . html . Head () ; 
if (CRMConnector .g_DEVICE instanceof PalmVIIDevice | | CRMConnector . gJDEVICE *£ 
instanceof Omni SkyDe vice) 

Meta meta = new Meta ( "name" , "PalmComputingPlatf orm" , "true"); 
head. addChild (meta) ; 

com. thinairapps. tag. html. Bold bold = new com . thinairapps . tag . html . Bold ( "Sample CRM 

Connector" ) ; 
head. addChild (bold) ; 
doc . setHead( head) ; 

Body mBody = new Body ( ) ; 

com. thinairapps . tag. html .Paragraph para = new com . thinairapps . tag . html . Paragraph {) ; 
para. addChild (new com. thinairapps . tag . html . Text { " Please choose from the following kf 
...")>; 

mBody .addChild (para) ; 

String href = CRMConnector . path + "?" + CRMConnector .ACTION_FI ELD + "=" + 

CRMConnector. CREATE_ACTION + "&rnd=" + Math . random () ,- 
com. thinairapps. tag. html. Anchor anl = new com. thinairapps . tag . html .Anchor ( "Create" , 

href, new com. thinairapps . tag . html . Text ( "Create a new Item")); 

mBody . addChild (anl) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ()) ; 

String href2 = CRMConnector . path + + CRMConnector .ACT I ON_F I ELD + " = " + wr^ 

CRMConnector .VI EW_ACT I ON + " &amp ; rnd= " + Math . random ( ) ; 
com. thinairapps . tag. html .Anchor an2 = new com. thinairapps . tag . html .Anchor ( "Select " , ^ 

href2, new com. thinairapps . tag . html . Text ( "Select a View")); 

mBody. addChild (an2) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) ) ; 
doc . setBody (mBody) ; 

String resultString = doc . render () ; 
return resultString; 



/ * * 

* Renders the fields of a single Customltem 
* 

* ©param item the Customltem whose fields we should render 

* ©return the rendered deck. 
*/ 

static String renderCustomltemFields (Customltem item, ConnectorAccess access, String 
sessionld) throws Exception 

{ 

//Get the cache for this session 
Hashtable cache=null; 

cache = access .getSessionCache (sessionld) ; 
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//Storing the item being viewed in the cache 
String itemViewed; 

itemViewed = cache .get ( "ItemViewed" ). toString () ; 
//Get the messagelD 

String messagelD = ( (Storeltem) item) .getID ( ) ; 

//create the deck 
String url = null; 

HTMLTagDocument doc = new HTMLTagDocument { ) ; 

com. thinairapps.tag.html. Head head = new com . thinairapps . tag . html . Head () ; 
if (CRMConnector .g_DEVICE instanceof PalmVIIDevice | | CRMConnector . g_DEVICE * 
instanceof OmniSkyDevice) 

Meta meta = new Meta ( "name" , "PalmComputingPlatf orm" , "true") ; 
head.addChild (meta) ; 

com. thinairapps. tag. html. Bold bold = new com. thinairapps . tag . html . Bold ( "Sample CRM >£ 

Connector" ) ; 
head.addChild (bold) ; 
doc . setHead (head) ; 

Body mBody = new Body ( ) ; 

com. thinairapps . tag .html . Paragraph para = new com. thinairapps . tag . html . Paragraph () ; 
para.addChild(new com . thinairapps . tag . html . Text ( " I tern Fields:")) ; 

mBody . addChi Id (para) ; 

// Now add the fields and their values: 

//first get the Data object that contains all the info about our custom fields. 
Data customFields = item. getCustomFieldData () ; 

//Get an enumeration of the fields... 
Enumeration fieldEnum = customFields .getFields () ; 

// go through the fields, and add each one to the deck - we'll stop after 15, 
// to avoid any deck overflow problems 
int itemsDisplayed = 0; 

while (f ieldEnum.hasMoreElements () && itemsDisplayed < 15) 

{ 

String f ieldTextName = null; 
String f ieldTextValue = null; 

Field thisField = (Field) fieldEnum. nextElement () ,- 

//We must check the type, because that determines how we retrieve the field 
if (thisField.getTypeO Field . B00LEAN_VAL) 

f ieldTextName = thisField .getName () ; 
f ieldTextValue = ": " + thisField. getBoolean () ; 

lse if (thisField.getTypeO == Field . DOUBLEJVAL) 

f ieldTextName = thisField . getName () ; 
f ieldTextValue = " : " + thisField . getDouble () ; 

lse if (thisField.getTypeO == Field. INT_VAL) 

f ieldTextName = thisField . getName () ; 
f ieldTextValue = " : " + thisField. getlnt () ; 

lse if (thisField.getTypeO == Field . LONG_VAL) 



in 



f ieldTextName = thisField .getName () ; 

f ieldTextValue = " : " + thisField . getLong ( ) 
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else if (thisField.getType 0 == Field. STR ING_VAL ) 
{ 

f ieldTextName = thisField . getName ( ) ; 

f ieldTextValue = " : " + thisField. getString () ; 

else if {thisField.getType () == Field . DATEJVAL) 
{ 

f ieldTextName = thisField . getName () ; 

f ieldTextValue = " : " + thisField. getDate () ; 

//Transform the field name to the what we want to display as the field name 

//We do this because we want the actual field names in Domino or Exchange to have 

//no spaces, but we want the display names to have spaces (i.e. \l 

CustomerName- -Customer Name) 
String f ieldDisplay=null ; 

if (f ieldTextName . equals ("CustomerName") ) 

fieldDisplay=" Customer Name"; 
else if (f ieldTextName .equals ("Position")) 

f ieldDisplay= "Position" ; 
else if (f ieldTextName. equals ("CompanyName") ) 

fieldDisplay=" Company Name" ; 
else if (f ieldTextName . equals ("Industry")) 

fieldDisplay= "Industry" ; 
else if (f ieldTextName .equals ( " ItemCreated" ) ) 
_ f ieldDisplay= !, Item Created"; 

O else if (f ieldTextName .equals ("Salescontact")) 

fieldDisplay= "Sales Contact "; 
else if (f ieldTextName .equals ( "Ac count Number ") ) 

fieldDisplay=" Account Number"; 
else if (f ieldTextName. equals ( "CustomerStatus " ) ) 

fieldDisplay= "Customer Status"; 
//If there 1 a a field on the form that we're not expecting, 
//don't display it 
else 

{ 

continue ; 

} 

mBody.addChild(new Text { f ieldDisplay) ) ; 
mBody.addChild(new Text (f ieldTextValue) ) ; 



} 



mBody . addChild (new Break () ) ; 
itemsDisplayed++ ; 



//Link Home 

String href = CRMConnector .path+ " ?rnd= "+Math. random( ) ; 

com. thinairapps . tag. html .Anchor anl = new com. thinairapps . tag . html .Anchor ( "Home" , * 
href, new com. thinairapps . tag . html . Text ( "Start Again...")); 

mBody .addChild (new com . thinairapps . tag . html . Break () ) ; 
mBody .addChild (anl) ; 

mBody . addChild (new com. thinairapps . tag . html . Break ( ) ) ; 
//Link to edit the Item 

String editHref = CRMConnector . path+ " ? "+ CRMConnector .ACT I ON_F I ELD + "=" + ^ 
CRMConnector .EDIT_ACTION + " &amp ; editPrm= " + itemViewed + " &amp ; rnd= " +Math . random / 

<> ; 

com. thinairapps . tag .html .Anchor an2 = new com. thinairapps . tag . html . Anchor ( "Edit " , ^ 
editHref, new com . thinairapps . tag . html . Text { "Edit Item")); 

mBody .addChild (an2) ; 

mBody . addChild (new com. thinairapps . tag .html . Break ( ) ) ; 
doc . set Body (mBody) ; 

String resultString = doc . render () ; 
return resultString; 
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/** This method renders a simple message, either an error or a success, 

* then links back to the main page 

* ©param message the message to be presented to the user 

* ©return the rendered HTML deck 
*/ 

static String renderMessage (String message) 
{ 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps . tag .html .Head head = new com. thinairapps . tag . html . Head () ; 
if (CRMConnector .g_DEVICE instanceof PalmVIIDevice | | CRMConnector .g__DEVTCE 
instanceof OmniSkyDevice) 

{ 

Meta meta = new Meta ( "name" , "PalmComputingPlatf orm" , "true") ; 

head.addChild (meta) ; 

} 

com. thinairapps .tag. html .Bold bold = new com. thinairapps . tag . html . Bold ( "Sample CRM 

Connector") ,* 
head.addChild (bold) ; 
doc . setHead (head) ; 

Body body = new Body ( ) ; 

O com. thinairapps . tag .html . Paragraph para = new com. thinairapps . tag . html . Paragraph {) ; 

»p para . addChild (new com . thinairapps . tag . html . Text (message) ) ,- 

ifk body .addChild (para) ; 

■7s body. addChild (new com. thinairapps . tag .html .Break ()) ; 

= SS //Link home 

flJ String href = CRMConnector . path+ " ?rnd= 11 +Math . random () ; 

.2 com. thinairapps . tag .html .Anchor anl = new com. thinairapps . tag . html .Anchor ( "Start " , kf 

href, new com . thinairapps . tag . html . Text ( "Start again. ..")); 

body .addChild (anl) ; 

body . addChild (new com . thinairapps . tag . html . Break ( ) ) ; 
§3 doc . setBody (body) ; 

]ll String resultString = doc . render () ; 

^ return resultString; 



/ * * 

* This method renders a deck with several cards including a welcome card and card for \£ 

entering information 

* 

* This method makes use of the ThinAir HTML Tag Library for HTML markup creation. For 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server 

Development Guide . 

* 

* ©return the rendered deck. 
*/ 

static String renderlnputForm ( ) 

{ 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com . thinairapps . tag . html . Head head = new com. thinairapps . tag . html . Head () ; 

if (CRMConnector .g_DEVICE instanceof PalmVIIDevice | | CRMConnector .g_DEV ICE ^ 

instanceof . OmniSkyDevice) 

{ 

Meta meta = new Meta ( "name " , "PalmComputingPlatf orm" , "true"); 
head . addChild (meta) ; 

} 
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com. thinairapps. tag. html .Bold bold = new com. thinairapps . tag .html .Bold ( "Sample CRM 

Connector") ; 
head. addChild (bold) ; 
doc . setHead{ head) ,- 

Body body = new Body ( ) ; 

com.thinairapps.tag.html .Paragraph para = new com. thinairapps . tag . html . Paragraph () ; 
body . addChi Id (para) ; 



//Create the form 
String href = "/crm" ; 

com. thinairapps . tag .html . Form input Form 
Form" , href , "POST" ) ; 



new com. thinairapps . tag .html . Form ("Sample 



//Create the inputs and selects 

com. thinairapps . tag . html . Labeledlnput custName = new Labeledlnput ( "cstnm" , "Customer *r 
Name : " ) ; 

com. thinairapps. tag. html. Labeledlnput psnName = new Labeledlnput ( "psn" , " Position :") ; 
com.thinairapps.tag.html .Labeledlnput compName = new Labeledlnput ( "cnm" , "Company \£ 
Name : " ) ; 

com.thinairapps.tag.html .Select industryName = new Select ("industry"); 
industryName .addOption ("a", "Advertising"); 



industryName . addOption ( "b" 
industryName . addOption ( " c " 
industryName . addOption ( "d" 
industryName . addOption ( "e" 
industryName .addOption ("f" 
indus t ryName . addOpt ion ( " g " 
indus t ryName . addOpt ion ( " h " 
com . thinairapps . tag . html . Select 
salesContactName . addOpt ion 
salesContactName . addOption 
salesContactName . addOption 
salesContactName . addOption 
salesContactName . addOption 
salesContactName . addOption 
salesContactName . addOption 
salesContactName . addOption 



"Consulting" ) ; 
"Entertainment") ; 
"Finance" ) ; 
"Government") ; 
"Health Care" ) ; 
"Manufacturing") ; 
"Retail") ; 
salesContactName = new Select ("sc"); 
"a" , "Mikhail Bulgakov") ; 
"b" , "Neil Diamond" ) ; 
"c" , "Sam Donaldson") ; 
"d" , "Richard Feynman" ) ; 
"e", "Joe Frazier" ) ; 
"f", "Arthur Rimbaud") ; 
"g" , "Leon Trotsky" ) ; 
"h" , "Michelle Yeoh" ) ; 



com.thinairapps.tag.html .Labeledlnput anName = new Labeledlnput ( "an" , "Account Number* 
:*'); 

com. thinairapps . tag .html .Select custstatusName = new Select ( "custstatus " ) ; 

custstatusName. addOption ("a", "Needs First Contact"); 

custstatusName . addOption ("b", "Needs Follow-Up"); 

custstatusName .addOption ("c" , "Needs Credit Approval") ; 

custstatusName . addOption ( "d" , "Needs to be Invoiced"); 

custstatusName .addOption ( "e" , "Credit Approved" ) ; 

custstatusName .addOption (" f "," Invoice Sent"); 

custstatusName . addOption ("g", "Credit Denied"); 

custstatusName . addOption ( "h" , "Dead End" ) ; 
com. thinairapps. tag. html .SubmitBut ton submit = new SubmitButton ( "Submit " # "Submit ") ; 

//Add the inputs and selects to the Form 

//Hidden 

inputForm.addChildtnew Input ( "hidden" , "action", "display")) ; 

input Form. addChi Id (new Labeledlnput ("cstnm", "Customer Name : " ) ) ; 
input Fo rm. addChi Id (new com . thinairapps . tag . html . Break ()) ; 

inputForm.addChild (new Labeledlnput ("psn" f "Position: ") } ; 
inputForm.addChild (new com . thinairapps . tag . html . Break ()) ; 

inputForm.addChild (new Labeledlnput ( "cnm" , "Company Name : " ) ) ,- 
inputForm . addChild ( new com . thinairapps . tag . html . Break ( ) ) ; 



inputForm.addChild 
inputForm. addChild 
inputForm. addChild 



(new Text ( "Industry :  ") ) ; 
(industryName) ; 

(new com. thinairapps . tag .html .Break ( ) ) ; 
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input Form . addChild 
input Form . addChi Id 
input Form. addChild 



(new Text ("Sales Contact :   ")) ; 
(salesContactName) ; 

(new com. thinairapps.tag.html . Break () ) 



input Form. addChild (new Labeledlnput ("an", "Account Number:")); 

inputForm. addChild (new com. thihairapps . tag . html . Break () ) ; 

inputForm. addChild (new Text ( "Customer Status : &nbsp ;")) ; 

inputForm. addChild (custstatusName) ; 

inputForm. addChild (new com. thinairapps . tag . html . Break ()) -; 

inputForm. addChild (new com . thinairapps . tag . html . Break {)) ; 



inputForm. addChild 
inputForm. addChild 



(submit) ; 

(new com.thinairapps.tag.html . Break () ) 



//Set the href with the values from the user 

//href = CRMConnector .path + " ?action=display& c s t nm= $c s t nm&amp ; psn= $psn&amp ; cnm=$ kf 
cnm&amp ; industry= $ indus t ry&amp ; spm= $ spm&amp ;sc=$ salescontact &amp ; an= $an&amp ; \l 
custstatus=$custstatus&rnd="+Math. random ( ) ; 
//Add the Form to the body- 
body . addChild ( inputForm) ; 
._ body .addChild (new com . thinairapps . tag . html . Break ()) ; 

i«J //Add the body to the document 

*P doc . setBody (body) ; 

String resultString = doc . render () ; 
2 return resultString; 



5 /** 

\r\ * Display to the user the available ways that they can view the data in the folder. 

•S * renderOptionMenu ( ) renders an option screen, users select one of those options and 

hJj * Handle () checks the URL and then calls this method if users wanted to see all the * 

M views 

Ifl * available to them 

M * ©return the rendered HTML deck 

U */ 

static String renderAvailableViews () 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps . tag .html .Head head = new com . thinairapps . tag . html . Head () ; 
if (CRMConnec tor .g_DEVICE instanceof PalmVIIDevice | | CRMConnector .g_DEVICE * 
instanceof OmniSkyDevice) 

Meta meta = new Meta ( "name" , "PalmComputingPlatf orm" , "true"); 
head. addChild (meta) ; 

com. thinairapps . tag .html .Bold bold = new com. thinairapps . tag . html . Bold ( "Sample CRM 

Connector" ) ; 
head. addChild (bold) ; 
doc . setHead (head) ; 

Body mBody = new Body ( ) ; 

com. thinairapps . tag -html . Paragraph para = new com . thinairapps . tag . html . Paragraph () ; 
para. addChild (new com . thinairapps . tag . html . Text ( "Select a View:")); 

mBody . addChild (para) ; 

String href = CRMConnector . path + "?" + CRMConnector .ACTION_F I ELD + "=" + * 

CRMConnector . VI EW_B Y_STATUS + " &amp ; rnd= " + Math . random ( ) ; 
com. thinairapps . tag .html .Anchor anl = new com. thinairapps . tag . html .Anchor ( "Status" , ^ 
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href, new com. thinairapps . tag - html . Text ( "View by Status")); 
mBody . addChild (anl ) ; 

mBody .addChild(new com. thinairapps . tag . html . Break () ) ; 

String href 2 = CRMConnector . path + "?" + CRMConnector . ACTION_FIELD + " = " + 

CRMConnector .VI EW_BY_INDUSTRY + " &amp ; rnd= " + Math . random () ; 
com. thinairapps. tag. html. Anchor an2 = new com. thinairapps . tag .html .Anchor * 

("Industry", href 2, new com . thinairapps . tag . html . Text ( "View by Industry")); 

mBody .addChild (an2) ; 

mBody .addChild (new com. thinairapps . tag . html . Break () ) ; 

String href 3 = CRMConnector . path + "?" + CRMConnector .ACT ION_FI ELD + "=" + 
CRMConnector . V I EW_BY_SALES CONTACT + " &amp ; rnd= " + Math . random ( ) ; 

com. thinairapps . tag. html .Anchor an3 = new com. thinairapps . tag . html .Anchor X 
("Salescontact", href 3, new com. thinairapps . tag . html . Text ( "View by Sales * 
Contact") ) ; 

mBody .addChild (an 3 ) ; 

mBody .addChild (new com . thinairapps . tag . html . Break () ) ; 
doc . setBody (mBody) ; 

String resultString = doc . render () ; 
return resultString; 



/* * 

* This method renders the fields in a selected view. 

* TO DO -- display the number of items that have each field 

* TO DO -- turn this connector into a collection of widgets that 

* are more generic 
* 

* ©param customltems All of the items in the folder 

* ©param view The view that the user wants to use on these items 

* ©return A rendered HTML deck 

static String renderView (Storel terns customltems, String vxew) 
HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps . tag .html .Head head - new com. thinairapps . tag . html . Head () ; 
if (CRMConnector. g_DEVICE instanceof PalmVIIDevice | | CRMConnector . g_DEVICE 
instanceof OmniSkyDevice) 

Meta meta = new Meta { "name" , "PalmComputingPlatf orm" , "true"); 
head. addChild (me ta) ,- 

com. thinairapps . tag .html . Bold bold = new com. thinairapps . tag . html . Bold ( "Sample CRM 

Connector" ) ; 
head. addChild (bold) ,- 
doc. setHead( head) ,- 

Body mBody = new Body ( ) ,- 

com. thinairapps . tag .html . Paragraph p = new com . thinairapps . tag . html . Paragraph {) ; 

if (view. equals (CRMConnector .VI EW_BY_STATUS ) ) 

p. addChild (new Text ("View By Customer Status:")); 
p. addChild (new Break ( ) ) ; 

//add the Paragraph 
mBody . addChild (p) ; 

com. thinairapps . tag. html .Paragraph p2 = new Paragraph ( Paragraph . AL I GN_LEFT) ; 



I * * 

//Links to the possible actions 
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String nfcHref = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELD + " = " 

CRMConnector . STS_NEEDS_FIRST_CONTACT + " &amp ; rnd= " + Math . random ( ) ; 
String nfHref = CRMConnector . pat h+ "?" + CRMConnector . ACT I ON_F I ELD + "=" 

CRMConnector . STS_NEEDS_FOLLOWUP + " &amp ; rnd= " + Math . random () ; 
String ncaHref = CRMConnector . pa th+ "?" + CRMConnector .ACT ION_FI ELD + " = " 

CRMConnector . STS_NEEDS_CREDIT_APPROVAL + " &amp ; rnd= " + Math . random ( ) ; 
String ntbiHref = CRMConnector .path+ "?" + CRMConnector .ACTION_FI ELD 

CRMConnector . STS_NEEDS_TO_BE_INVO ICED + "&rnd=" + Math . random () ; 
String caHref = CRMConnector . pa th+ "?" + CRMConnector .ACTION_FI ELD + "=" 

CRMConnector . STS_CREDIT_APPROVED + " &amp ; rnd= " + Math . random ( ) ; 
String isHref = CRMConnector . pat h+ ,, ? ,, + CRMConnector ,ACTION_F I ELD + " = " 

CRMConnector . STS_INVOICE_SENT + " &amp ; rnd= " + Math . random ( ) ; 
String cdHref = CRMConnector . pat h+ "?" + CRMConnector .ACTION_F I ELD + " = " 

CRMConnector . STS_CREDIT_DENIED + " &amp ; rnd= " + Math . random () ; 
String deHref = CRMConnector . path* "?" + CRMConnector .ACT I ON_F I ELD + " = " 

CRMConnector . STS_DEAD_END + " &amp ; rnd= " + Math . random () ; 



com. thinairapps . tag .html -Anchor nfcAnchor - new com. thinairapps . tag . html .Anchor 
( "FirstContact " , nfcHref, new com. thinairapps . tag . html .Text ( "Needs First 
Contact") ) ; 

com. thinairapps . tag . html .Anchor nf Anchor = new com . thinairapps . tag . html .Anchor *r 
( "FollowUp" , nfHref, new com . thinairapps . tag . html . Tex£ ( "Needs Follow-Up" ) ) ; 

com. thinairapps . tag . html .Anchor ncaAnchor = new com. thinairapps . tag . html -Anchor * 
( "Credit Approval " , ncaHref, new com. thinairapps . tag .html .Text ( "Needs Credit 
J Approval " ) ) ; 

3 com. thinairapps . tag . html .Anchor ntbiAnchor = new com. thinairapps . tag -html -Anchor * 

(% ("Invoice", ntbiHref, new com. thinairapps - tag . html . Text ( "Needs to be * 

% Invoiced" ) ) ,- 

2 com. thinairapps . tag . html .Anchor caAnchor = new com. thinairapps . tag .html .Anchor ^ 
5 (" Cr edit Approved " , caHref, new com. thinairapps . tag . html . Text ( "Credit \£ 
■J Approved " ) ) / 

"i com. thinairapps. tag. html. Anchor isAnchor = new com . thinairapps . tag . html .Anchor * 

2f ( "InvoiceSent" , isHref, new com. thinairapps . tag . html . Text (" Invoice Sent")); 

3 com. thinairapps . tag .html .Anchor cdAnchor - new com. thinairapps . tag .html .Anchor 

( "CreditDenied" , cdHref, new com. thinairapps . tag . html . Text { "Credit Denied")); 
^ com. thinairapps. tag. html. Anchor deAnchor = new com. thinairapps . tag . html .Anchor kT 

Z ( "DeadEnd" , deHref, new com . thinairapps . tag . html . Text ( "Dead End" )),- 

3 mBody.addChi Id (nfcAnchor) ; 

fl mBody . addChild (new com. thinairapps . tag . html .Break ()) ; 

1- mBody . addChild (nf Anchor) ; 

^ mBody . addChild (new com . thinairapps . tag . html . Break ( ) ) ; 

^ mBody .addChild (ncaAnchor) ; 

mBody .addChild (new com. thinairapps . tag .html .Break () ) ; 

mBody. addChild (ntbiAnchor) ; 

mBody . addChild (new com. thinairapps . tag .html .Break ( ) ) ; 
mBody . addChild (caAnchor) ; 

mBody . addChild (new com. thinairapps . tag .html . Break () ) ; 
mBody . addChild { isAnchor) ; 

mBody .addChild (new com. thinairapps. tag. html . Break ( ) ) ; 
mBody .addChild (cdAnchor) ,* 

mBody . addChild (new com . thinairapps . tag . html . Break () ) ; 
mBody . addChild (deAnchor) ; 

mBody - addChild (new com. thinairapps . tag . html . Break {) ) ; 
*/ 

/////////////////////////////////////////////////////////////////// 
//Add links to all the possible actions 

String [] statusHREFNames * 
= {"nfcHref", "nfHref", "ncaHref", "ntbiHref", "caHref", "isHref", "cdHref", "deHref 



" } ; 

String [] statusURLParams = { CRMConnector . STS__NEEDS_F I RST_CONTACT, CRMConnector . * 
STS_NEEDS_FOLLOWUP , CRMConnector . S TS__NEEDS_CRED I T_AP PROVAL , CRMConnector . 
STS_NEEDS_TO_BE_INVOICED , CRMConnector . STS_CREDIT_APPROVED , CRMConnector . 



STS_INVOICE_SENT, CRMConnector . STS_CREDIT_DENI ED, CRMConnector . STS_DEAD_END } ; 
String [] statusAnchorValues * 

= { "FirstContact " , "FollowUp", "Credit Approval " , "Invoice", " Credit Approved " , "Invtf 

oiceSent" , "CreditDenied" , "DeadEnd" } ; 
String [] statusAnchorDisplayText = {"Needs First Contact " , "Needs ^ 
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Fol low- Up " , "Needs Credit Approval ", "Needs to be Invoiced" , "Credit 
Approved" , "Invoice Sent " , "Credit Denied" , "Dead End" }; 
com. thinairapps . tag . html .Anchor [] statusAnchorNames = {new com . thinairapps . tag . * 
html .Anchor { "nfcAnchor" ) ,new com . thinairapps . tag . html . Anchor ( "nf Anchor" ) , new * 
com. thinairapps. tag. html. Anchor ( "ncaAnchor" ) , new com.thinairapps.tag.html. 
Anchor ( "ntbiAnchor" ) , new com. thinairapps . tag . html .Anchor ( "caAnchor" ) , new com./ 
thinairapps . tag .html .Anchor ( 11 isAnchor" ) , new com. thinairapps . tag . html .Anchor / 
( "cdAnchor" ) , new com . thinairapps . tag . html .Anchor { "deAnchor" ) }; 



int i; 
for (i 
{ 



} 



0; i < 8; i++) 



statusHREFNames [i] = CRMConnector . path+ "?" + CRMConnector .ACT I ON_FI ELD 

+ "=" + statusURLParams [i] + " &amp ; rnd= " + Math . random () ; 
statusAnchorNames [i] = new com. thinairapps . tag . html .Anchor ( statusAnchorValues 
[i] , statusHREFNames [i] , new com. thinairapps . tag .html .Text 
(statusAnchorDisplayText [i] ) ) ; 
mBody. addChild (statusAnchorNames [i] ) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) ) ; 



//////////////.///////////////////////////////////////////////////// 
//add the body 
doc . set Body (mBody) ; 

} 

« else if (view. equals (CRMConnector .VI EW__BY_INDUS TRY) ) 

i { 

y p. addChild (new Text ("View By Industry Name : " ) ) ,- 

*f\ p. addChild (new Break ( ) ) ; 



//add the Paragraph 
mBody . addChild (p) ; 

com. thinairapps . tag .html . Paragraph p2 = new Paragraph (Paragraph .ALIGN_LEFT) ,- 



//Links to the possible actions 

String advHref = CRMConnector . path+ " ?" + CRMConnector ,ACTION_ 

CRMConnector . I_ADVERTISING + "&rnd=" + Math . random () ,- 
String conHref = CRMConnector .path+ "?" + CRMConnector .ACTION_ 

CRMConnector . I_CONSULTING + " &amp ; rnd= ,! + Math . random ( ) ; 
String entHref = CRMConnector .pa th+ "?" + CRMConnector .ACT ION_ 
CRMConnector . I_ENTERTAINMENT + " &amp ; rnd= 11 + Math . random ( ) 
String finHref = CRMConnector . path+ "?" + CRMConnector .ACTI0N_ 

CRMConnector . I_FINANCE + " &amp ; rnd= " + Math . random () ; 
String govHref = CRMConnector .path+ "?" + CRMConnector .ACTION_ 
CRMConnector . I _GOVE RNMENT + " &amp ; rnd= " + Ma th . random ( ) ; 

CRMConnector .pat h+ "?" + CRMConnector . ACT ION_ 
. I __HE ALTHCARE + " &amp ; rnd= " + Math . random ( ) ; 
CRMConnector .path+ "?" + CRMConnector .ACT I ON_ 
. I_MANUFACTURING +• " &amp ; rnd= " + Math . random ( ) 
CRMConnector .path+ "?" + CRMConnector .ACTION 



String heaHref 

CRMConnector . 

String manHref 

CRMConnector . 

String retHref 



FIELD + 

FIELD + 

FIELD + 

FIELD + 

FIELD + 

FIELD + 

FIELD + 

FIELD + 



CRMConnector . I_RETAIL + "&rnd=" + Math . random ( ) 



com. thinairapps . tag . html .Anchor advAnchor = new com. thinairapps . tag . html .Anchor 

("Advertising", advHref, new com . thinairapps . tag . html . Text ( "Advertising ") ) ; 
com. thinairapps . tag . html .Anchor conAnchor = new com . thinairapps . tag . html . Anchor 

("Consulting", conHref, new com. thinairapps . tag .html . Text ( "Consulting" )) ; 
com. thinairapps . tag .html .Anchor entAnchor = new com . thinairapps . tag . html . Anchor 

("Entertainment", entHref, new com. thinairapps . tag . html . Text 

("Entertainment") ) ; 

com. thinairapps . tag . html .Anchor finAnchor = new com . thinairapps . tag . html . Anchor 

("Finance", finHref, new com . thinairapps . tag . html . Text (" Finance" )) ; 
com. thinairapps . tag . html .Anchor gov Anchor = new com . thinairapps . tag . html . Anchor 

("Government", govHref, new com. thinairapps . tag . html . Text ( "Government ")) ; 
com. thinairapps . tag .html .Anchor heaAnchor = new com . thinairapps . tag . html . Anchor 

( "Healthcare" , heaHref, new com . thinairapps . tag . html . Text ( "Healthcare ")) ; 
com. thinairapps . tag . html .Anchor manAnchor = new com. thinairapps - tag - html . Anchor 

("Manufacturing", manHref, new com. thinairapps . tag - html . Text 

("Manufacturing") ) ; 
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com. thinairapps . tag . html .Anchor retAnchor = new com. thinairapps . tag .html .Anchor 
("Retail", retHref, new com . thinairapps . tag . html . Text { "Retail ")) ; 



mBody .addChild(advAnchor) ; 

mBody .addChild(new com . thinairapps . tag. html . Break ( 
mBody .addChi Id (conAnchor) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ( 
mBody .addChi Id (en t Anchor) ; 

mBody .addChild (new com . thinairapps . tag .html .Break ( 
mBody. addChild (finAnchor) ; 

mBody. addChild (new com . thinairapps . tag .html .Break ( 
mBody . addChi Id ( govAnchor ) ; 

mBody. addChild (new com . thinairapps . tag . html . Break ( 
mBody . addChi Id ( heaAnchor ) ; 

mBody. addChild (new com . thinairapps . tag .html .Break ( 
mBody . addChild (manAnchor) ; 

mBody . addChild (new com . thinairapps . tag .html . Break ( 
mBody . addChild (retAnchor) ; 

mBody . addChild (new com. thinairapps . tag .html .Break ( 
*/ 

/////////////////////////////////////////////////////////////////// 
//Add links to all the possible actions 

String [] industryHREFNames ^ / 

= { "advHref" , "conHref " , "entHref " , "f inHref " , "govHref " , "heaHref M , "manHref" , "ret/ 
™ Href"}; 

^ String [] industryURLParams = {CRMConnector . I_ADVERT I SING, CRMConnector . / 

*0 I_CONSULTING, CRMConnector . I_ENTERTAINMENT, CRMConnector . I_F1NANCE / CRMConnector / 

lU . I _GOVERNMENT , CRMConnector . I_HEALTHCARE , CRMConnector . I _MANUFACTUR I NG , / 

CRMConnector . I_RETAI L } ; 

String [] industryAnchorValues / 
s t~ = { "Advertising" , "Consulting" , "Entertainment" , "Finance" , "Government" , "Heal the/ 

Ilj are" , "Manufacturing" , "Retail" } ; 

String [] industryAnchorDisplayText / 
^ = {"Advertising", "Consulting", "Entertainment", "Finance", "Government", "Heal the/ 

^ are" , "Manufacturing" , "Retail" } ; 

s com. thinairapps . tag .html .Anchor [] industryAnchorNames = {new com. thinairapps . tag/ 

!□ .html .Anchor ( "advAnchor" ), new com. thinairapps . tag . html .Anchor ( "conAnchor ") , / 

if* new com. thinairapps . tag .html .Anchor ( 11 entAnchor" ), new com . thinairapps . tag . html / 

IIS .Anchor ( "f inHref "), new com. thinairapps . tag . html .Anchor ( "govAnchor" ), new com. / 

Ss? thinairapps . tag . html .Anchor ( "heaAnchor" ), new com. thinairapps . tag . html .Anchor / 

:jl ("manAnchor") ,new com. thinairapps . tag . html .Anchor ( "retAnchor ")} ; 



~ int i ; 

^ for (i = 0; i < 8; i++) 

{ 

industryHREFNames [i] = CRMConnector . path+ "?" + CRMConnector .ACT I ON__F I ELD 
+ " = " + industryURLParams [ i ] + " &amp ; rnd= " + Math . random ( ) ; 

industryAnchorNames [i] = new com. thinairapps . tag . html .Anchor 

(industryAnchorValues [i] , industryHREFNames [i] ,new com. thinairapps . tag . 
html .Text (industryAnchorDisplayText [i] ) ) ; 

mBody .addChild (industryAnchorNames [i] ) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) ) ; 

} 

/////////////////////////////////////////////////////////////////// 

//add the body 

doc . set Body (mBody) ; 

} 

else if (view. equals (CRMConnector . VIEW_BY_SALESCONTACT) ) 
{ 

p. addChild (new Text ( "View By Sales Contact:")); 
p. addChild (new Break ()) ; 

//add the Paragraph 
mBody . addChild (p) ; 



/ 
/ 



com. thinairapps . tag . html . Paragraph p2 = new Paragraph { Paragraph . ALIGN_LE FT) ; 



//Links to the possible actions 



C: \TASS\WirelessSDK\ . . \Connectors\CRM\src\CRMHTMLRenderer . java 



12 



String arHref = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELD + 

CRMConnector . S C_ARTHUR_R I MB AUD + " &amp ; rnd- " + Math . random ( ) ; 
String jfHref = CRMConnector . pat h+ " ? " + CRMConnector .ACT I ON_F I ELD + 

CRMConnector .SC_JOE_FRAZ I ER + "&rnd=" + Math . random () ,• 
String ItHref = CRMConnector . pat h+ "?" + CRMConnector .ACT I ON__F I ELD + 

CRMConnector. SC_LEON_TROTSKY + "&rnd=" + Math . random () ; 
String myHref = CRMConnector . path+ "?" + CRMConnector .ACT I ON_F I ELD + 

CRMConnector. SC_MICHELLE_YEOH + "&rnd=" + Math . random () ; 
String mbHref = CRMConnector . path+ "?" + CRMConnector .ACT I ON_F I ELD + 

CRMConnector. SC_MIKHAIL_BULGAKOV + » &amp ; rnd= " + Math . random () ; 
String ndHref = CRMConnector . path+ "?" + CRMConnector .ACT I ON_F I ELD + 

CRMConnector . S C_NE I L_D I AMOND + " &amp ; rnd= " + Math . random ( ) ; 
String rfHref = CRMConnector . path+ "?" + CRMConnector .ACTION_F I ELD + 

CRMConnector . SC_RICHARD_FEYNMAN + " &amp ; rnd= " + Math . random () ; 
String sdHref = CRMConnector . path+ "?" + CRMConnector .ACTION_F I ELD + 

CRMConnector. SC_SAM_DONALDSON + n &amp ; rnd= " + Math . random () ; 

com. thinairapps . tag . html .Anchor arAnchor = new com. thinairapps . tag . html . Anchor 

("Rimbaud", arHref, new com. thinairapps . tag .html . Text ( "Arthur Rimbaud")); 
com. thinairapps . tag . html .Anchor jf Anchor = new com. thinairapps . tag . html .Anchor 

("Frazier", jfHref, new com. thinairapps . tag . html . Text ( "Joe Frazier")); 
com. thinairapps . tag . html .Anchor ItAnchor = new com . thinairapps . tag . html .Anchor 

("Trotsky", ItHref, new com. thinairapps . tag . html . TextJ "Leon Trotsky") ) ; 
com. thinairapps . tag . html .Anchor myAnchor = new com . thinairapps . tag . html .Anchor 
("Yeoh", myHref, new com . thinairapps . tag . html . Text ( "Michelle Yeoh")); 
*f com. thinairapps . tag . html .Anchor mbAnchor = new com. thinairapps . tag . html .Anchor 

0 ("Bulgakov", mbHref, new com. thinairapps . tag . html . Text ( "Mikhail Bulgakov")) 

jrt com. thinairapps . tag . html .Anchor ndAnchor = new com. thinairapps . tag . html .Anchor 

"\ ("Diamond", ndHref, new com. thinairapps . tag . html . Text ( "Neil Diamond")); 

2 com. thinairapps . tag .html .Anchor rf Anchor = new com. thinairapps . tag . html .Anchor 

W ("Feynman", rfHref, new com . thinairapps . tag . html . Text ( "Richard Feynman")); 

ij com. thinairapps . tag .html .Anchor sdAnchor = new com. thinairapps . tag . html .Anchor 

t | ("Donaldson", sdHref, new com. thinairapps . tag .html . Text ( "Sam Donaldson")); 

mBody.addChi Id (arAnchor) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) 

2 mBody. addChild(jf Anchor) ; 

~ mBody . addChild (new com . thinairapps . tag . html . Break ( ) 

*J mBody. addChild (ItAnchor) ; 

3 mBody .addChild (new com. thinairapps . tag . html . Break ( ) 
f| mBody .addChild (myAnchor) ; 

k mBody .addChild (new com. thinairapps . tag. html .Break () 

mBody .addChild (mbAnchor) ; 
^ mBody .addChild (new com. thinairapps . tag . html . Break ( ) 

mBody . addChi Id ( ndAnchor ) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) 
mBody .addChild (rf Anchor) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) 
mBody . addChild (sdAnchor) ; 

mBody. addChild (new com.thinairapps.tag.html . Break {) ] 

/////////////////////////////////////////////////////////////////// 
I * * 

//Add links to all the possible actions 

String [] salescontactHREFNames ^ 
= { "arHref" , "jfHref" , "ItHref" , "myHref" , "mbHref" , "ndHref" , "rfHref" , "sdHref" } ; 

String [] salescontactURLParams = {CRMConnector . SC_ARTHUR_RI MB AUD, CRMConnector . 

SC_JOE_FRA2IER, CRMConnector . SC_LEON_TROTSKY, CRMConnector . SC_MICHELLE_YEOH, * 
CRMConnector . SC_MIKHAIL_BULGAKOV, CRMConnector . SC_NEIL_DIAMOND, CRMConnector . * 
SC_RICHARD_FEYNMAN , CRMConnector . SC_SAM_DONALDSON} ; 

String [] salescontactAnchorValues * 
= { "Rimbaud" , "Frazier" , "Trotsky" , "Yeoh" , "Bulgakov" , "Diamond" , "Feynman" , "Donald 
dson" } ; 

String [] salescontactAnchorDisplayText = {"Arthur Rimbaud" , "Joe Frazier ", "Leon * 
Trotsky" , "Michelle Yeoh" , "Mikhail Bulgakov" , "Neil Diamond" , "Richard ^ 
Feynman" , "Sam Donaldson" } ,- 

com. thinairapps . tag . html .Anchor [] salescontactAnchorNames = {new com . thinairapps 
. tag .html .Anchor ( "arAnchor" ) , new com . thinairapps . tag . html .Anchor ( " j f Anchor " ) , 
new com. thinairapps . tag . html .Anchor ( "ItAnchor" ) , new com. thinairapps . tag .html . 
Anchor ( "myAnchor" ), new com . thinairapps . tag . html . Anchor ( "mbAnchor "), new com. 
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thinairapps . tag .html .Anchor ( "ndAnchor" ) , new com . thinairapps . tag . html .Anchor w 
("rf Anchor") ,new com . thinairapps . tag . html .Anchor (" sdAnchor" ) }; 



int i; 

for (i = 0; i < 8; i++) 

^ salescontactHREFNames [i] = CRMConnector . path* "?" + CRMConnector .ACTI ON_F I ELD 
+ "= n + salescontactURLParams [i] + " &amp ; rnd= " + Math . random () ; 

salescontactAnchorNames [i] = new com . thinairapps . tag . html .Anchor * 
( salescontact AnchorValues [i] , salescontactHREFNames [i] , new com. thinairapps 
. tag. html .Text ( salescontactAnchorDisplayText [i] ) ) ; 

mBody .addChild( salescontactAnchorNames [i] ) ; 

mBody .addChild (new com. thinairapps . tag . html . Break () ) ; 

} 

*/ 

/////////////////////////////////////////////////////////////////// 

//add the body 

doc . setBody (mBody) ; 

} 

String resultString = doc . render () ; 
return resultString; 

} 



•■f% /** 

% *A user selects a field value by which to sort the contents of the folder and 
y * then this method is called to display all the items that have that value 
iz * 

* ©param fieldValue The value of the field by which the user wants to sort the folder 
% * ©param access A handle to Connect or Access and the ThinAir Server services 

2 * ©param sessionld An identifier of the user's already established session 
U * ©return A collection of Storel terns that satisfy the criteria of the user 

*/ 

static String viewByField (String fieldValue, ConnectorAccess access. String sessionld) 
2f throws Exception 

3 HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps .'tag .html .Head head = new com. thinairapps . tag . html . Head () ; 
fj if (CRMConnector .g_DEVICE instanceof PalmVIIDevice | | CRMConnector ,g_DEVICE * 

s=J instanceof OmniSkyDevice) 

^ { 

Meta meta = new Meta ( "name" , "PalmComputingPlatf orm" , "true") ; 
head. addChild (meta) ; 

com. thinairapps. tag. html .Bold bold = new com . thinairapps . tag .html . Bold ( "Sample CRM \£ 

Connector" ) ; 
head. addChild (bold) ; 
doc . setHead (head) ; 

Body mBody = new Body ( ) ; 

com. thinairapps . tag .html . Paragraph p = new Paragraph ( Paragraph . ALIGN_LEFT) ; 

p. addChild (new Text ("Matching Items:")); 
p. addChild (new Break ()) ; 

//add the Paragraph 
mBody .addChild (p) ; 

com. thinairapps . tag .html . Paragraph p2 = new Paragraph ( Paragraph .AL I GN_LEFT) ; 

//The cache for this session 
Hashtable cache = null; 

//The Vector that will store the items that have fields that match the incoming fields 
parameter 

Vector itemswMatchingf ields = new Vector(15);- 
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//Get the cache for this session 

cache = access .getSessionCache (sessionld) ; 

//Retieve the Store Items that we've already placed into the cache 
Storeltems customltems = ( (Storeltems) cache .get { "storeitems" )) ; 

//we get an Enumeration of the items... 

Enumeration sortedltemEnum = ( ( (Vector) customltems) .elements () ) ; 
boolean didAnyltemsMatch = false ; 

//Go through the items, and identify those that have the field that 

//has been passed in as the search parameter. 

int itemlterated = 0; 

String elementNumber = "elemnum"; 

String href = " " ; 

com. thinairapps .tag. html .Anchor itemAnchor = new com. thinairapps . tag . html .Anchor ( " 11 , * 
href) ; 

while ( sortedltemEnum. ha sMoreEl ements ( ) ) 

{ 

String fieldText = null; 

String companyName = null ; ^ , 

Customltem custltem = (CustomI tern) sortedltemEnum. nextElement {) ; 

3 //Get the fields of the item 

0 Data customFields - custltem. getCustomFieldData () ; 

^ //Get an enumeration of the fields 

2 Enumeration fieldEnum = customFields . getFields () ; 

eJ //If the search parameter matches a field on the item, then we return a link to *r 

^ //item with the item's company name displayed. 

9 boolean hasField = false ; 

while (f ieldEnum.hasMoreElements ( ) ) 

■* { 

~ Field thisField = (Field) fieldEnum. nextElement () ; 

D //Get the Item's Company Name field. We need it for displaying a link to thetf 

3 item. 

~ if (thisField. getName () .equals ("CompanyName")) 

{ 

^ companyName = thisField .getString () ; 

4 if (hasField == true) 

//Create the link to the Item, with the Company Name field rendered 
href = CRMConnector .path+ "?" + CRMConnector . ACTION_FIELD + + * 

CRMConnector . VIEW_BY_FIELD__ACTION + "& elemnum= " + ^ 
itemlterated + "&rnd^" + Math, random ( ) ; 

//Initialize the anchor 

itemAnchor = new Anchor ( "CompanyName" , href , new com . thinairapps . tag . * 

html .Text (companyName) ) ; 
//Add the Break 

mBody .addChild (new com . thinairapps . tag . html . Break () ) ; 

//Add the anchor 

mBody .addChild (itemAnchor) ; 

didAnyltemsMatch = true; 

//Add to our Vector of items with matching fields 
itemswMatchingf ields . addElement (custltem) ,- 
companyName = null ; 
hasField = false; 
break ; 

} 

else 

continue ,- 
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} 

//We will display links only to those items that match the criteria that the 
//user is asking for. 

else if (thisField.getStringO .equals (fieldValue) ) 
{ 

hasField = true; 

if ( ! (companyName == null)) 

{ 

//Create the link to the Item, with the Company Name field rendered 
href = CRMConnector .path* "?" + CRMConnector .ACTION_F I ELD + + \£ 

CRMConnector . VIEW_BY_FIELD_ACTION + " &amp ; e 1 emnum= " + 
itemlterated + M &amp ; rnd- " + Math . random () ; 

//Initialize the anchor 

itemAnchor = new Anchor ( "CompanyName" , href , new com. thinairapps - tag . 

html . Text (companyName) ) ; 
//Add the Break 

mBody . addChild (new com . thinairapps . tag . html . Break ()) ; 

//Add the anchor 

mBody . addChild (itemAnchor) ; 

didAnyltemsMatch = true; 

,„ //Add to our Vector of items with matching fields 

?3 , itemswMatchingf ields . addElement (custltem) ; 

p companyName = null; 

p hasField = false;' 

^ break ; 

"i. > 

1= else 

continue; 

} 

} // end while 
itemIterated-»-+ ; 

} 



//If no items matched the criteria, render this fact 
if (didAnyltemsMatch == false) 

mBody .addChild (new com . thinairapps . tag .html . Break ( ) ) ; 
mBody .addChild (new Text ( "No Items to Display") ); 
mBody .addChild (new com . thinairapps . tag . html . Break ( ) ) ; 
mBody .addChild (new com. thinairapps . tag . html . Break ( ) ) ; 

} 

else if ( ! (didAnyltemsMatch == false) ) 

mBody . addChild (new com. thinairapps . tag . html . Break ()) ; 

} 

//link home. 

String startHref = CRMConnector . path+ " ?rnd= " +Math . random () ; 
//Initialize the anchor 

com. thinairapps . tag .html .Anchor start Anchor = new Anchor ( "Start ", startHref , new com. * 

thinairapps . tag . html . Text ( "Start again ...")); 
//Add the Break 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) ) ; 

//Add the anchor 

mBody .addChild (start Anchor) ; 

//add the body 

doc . setBody (mBody) ; 

return doc . render ( ) ; 
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* Renders an input form with the values preset 
* 

* Pass in the field values that the item had. 
* 

*/ 

static String editltem {CustomI tern item, String messagelD) 

//Get the Data object that contains all our custom fields. 
Data customFields = item. getCustomFieldData ( ) ; 

//Get the fields that we're expecting 

String customerNameField = customFields .getField { "CustomerName" ) .valueToSt ring () ; 
String positionField = customFields .getField{ "Position" ) . valueToString () ; 
String companyNameField = customFields . getField ( "Company Name" ) .valueToString {) ; 
String industryField = customFields .getField ( " Industry" ) .valueToString () ; 
String itemCreatedField = customFields .getField ( "ItemCreated" ) .valueToString () ,- 
String salesContactField = customFields .getField ( "Salescontact" ) .valueToString () ; 
String accountNumberField = customFields . getField { "Ac count Number" ). valueToString () ; 
String customerStatusField = customFields .getField ( "CustomerStatus ") .valueToString () ; 



^ HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

™ com. thinairapps .tag. html .Head head = new com. thinairapps . tag . html . Head () ,- 

P if (CRMConnector ,g_DEVICE instanceof PalmVIIDevice | | CRMConnector . g_DEVICE instanceof * 
Q OmniSkyDevice) 

2 Meta meta = new Meta ("name", "PalmComputingPlatf orm" , "true") ; 

h head. addChild (meta) ; 

ij } 

uj com. thinairapps . tag. html .Bold bold = new com. thinairapps . tag . html . Bold { "Sample CRM mr 
Connector" ) ; 
head. addChild (bold) ; 
doc . setHead (head) ; 



Body body = new Body ( ) ; 

com. thinairapps . tag. html . Paragraph para = new com. thinairapps . tag . html . Paragraph () ; 
body .addChild (para) ; 

//Create the form 
String href ="/crm" ; 

com. thinairapps . tag. html . Form inputForm = new com. thinairapps . tag . html . Form { "Sample *r 
Form" , href , "POST" ) ; 



//Create the inputs and selects 

com. thinairapps .tag. html . Label edlnput custName = new Labeledlnput ( "cstnm" ," input " , 

customerNameField, "Customer Name : " ) ; 
com. thinairapps. tag. html. Labeledlnput psnName = new Labeledlnput ("psn", "input", 

positionField, "Position : " ) ; 
com. thinairapps . tag. html .Labeledlnput compName = new Labeledlnput ( "cnm" ," input " , 

companyNameField, "Company Name: " ) ; 



//Industry 

com. thinairapps . tag .html .Select industryName = new Select ("industry"); 
String [] indust ryURLParams = {"a", "b" , "c", "d", "e " , " f " , "g" , "h" } ; 

String [] industries ^ 
= { "Advertising" , "Consulting" , "Entertainment" , "Finance" , "Government" , "Healthcare" , "Ma/ 
nufacturing" , "Retail" } ; 

com thinairapps . tag . html .Option [] industryOptions=new Option [8] ,- 

int i; 

for (i = 0; i < 8; i++) 

industryOptions [i] = new Option ( indust ryURLParams [i] , industries [i] ) ; 
if (industryField. equals (industries [i] ) ) 



# 
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industryOptions [i] . setSelected ( true) ; 

else 
{ 

industryOptions [i] . setSelected ( false) ; 
industryName .addOpt ion (industryOptions [i] ) ; 

} 

//Sales Contact 

com.thinairapps.tag.html .Select salesContactName = new Select ("sc"); 
String [] salesContactURLParams = {"a", "b" , "c", "d" , "e" , " f " , "g" , "h" } ; 

String [] salescontacts = {"Mikhail Bulgakov" , "Neil Diamond" , "Sam Donaldson" , "Richard u 

Feynman" , "Joe Frazier" , "Arthur Rimbaud" , "Leon Trotsky" , "Michelle Yeoh" } ; 
com. thinairapps .tag. html .Option [] salesContactOptions = new 0ption[8]; 
int j ; 

for (j = 0; j < 8; j++) 



{ 



salesContactOptions [j ] =new Option ( salesContactURLParams [j ] , salescontacts [j ] ) ; 
if (salesContactField. equals (salescontacts [j ]) ) 
salesContactOptions [j ] . setSelected (true) ; 

else 

salesContactOptions [j ] . setSelected (false) ,- 
salesContactName. addOpt ion (salesContactOpt ions [j] ) ; 



//Customer Status 

com. thinairapps . tag .html .Select custstatusName = new Select ( "custstatus" ) ,* 
String [J custstatusURLParams = {"a", "b" , "c", "d", "e" , «f " , "g" , "h" } ; 

String [] custstati = {"Needs First Contact ", "Needs Fol low- Up " , "Needs Credit vr 
Approval" , "Needs to be Invoiced" , "Credit Approved" , " Invoice Sent " , "Credit 
Denied" , "Dead End" } ; 

com. thinairapps.tag.html .Option [] custstatusOptions = new Option[8]; 

int h; 

for (h = 0; h < 8; h++) 

custstatusOptions [h] =new Option (custstatusURLParams [n] , custstati [h] ) ; 
if (customerStatusField. equals (custstati [h] ) ) 
custstatusOptions [h] . setSelected (true) ; 

else 

custstatusOptions [h] . setSelected (false) ; 
custstatusName .addOption (custstatusOptions [h] ) ; 

} 

com.thinairapps.tag.html .Label edlnput anName = new Labeledlnput ( "an" , " input M , * 
accountNumber Field, "Account Number: ") ; 

com. thinairapps. tag. html . SubmitButton submit = new SubmitButton ( "Submit "Submit ") ; 

//Add the inputs and selects to the Form 

//Hidden 

inputForm.addChildtnew Input ( "hidden" , "action", "update")) ; 
inputForm.addChild(new Input ( "hidden" , "MessagelD" , messagelD) ) ; 

input Form. addChi Id (anName) ; 

input Form. addChild (new com. thinairapps . tag . html . Break ()) ; 

inputForm. addChild (compName) ; 

inputForm. addChild (new com. thinairapps . tag . html . Break ()) ; 



inputForm. addChild (custName) ; 

inputForm. addChild (new com . thinairapps . tag . html . Break ()) ; 



# 
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inputForm.addChild (new Text C "Customer Status : &nbsp ;")) ; 
inputForm.addChild (custstatusName) ; 

inputForm . addChild (new com . thinairapps . tag . html - Break ( ) ) ; 

inputForm.addChild (new Text (" Industry :   " ) ) ; 

inputForm.addChild (industryName) ; 

inputForm.addChild (new com. thinairapps . tag . html . Break ( ) ) ; 

inputForm.addChild (psnName) ; 

inputForm.addChild (new com . thinairapps . tag . html . Break ()) ,- 

inputForm.addChild (new TextC'Sales Contact :   ")) ; 

inputForm.addChild ( salesContactName) ; 

inputForm.addChild (new com . thinairapps . tag . html . Break ()) ; 

inputForm.addChild (new com. thinairapps . tag . html . Break ()) ; 

inputForm.addChild (submit) ; 

inputForm.addChild (new com . thinairapps . tag . html . Break ()) ; 

//Add the Form to the body 
body . addChild ( inputForm) ; 

body. addChild (new com . thinairapps . tag . html . Break () ) ; 
//Add the body to the document 
doc . setBody (body) ; 

^ String resultString = doc . render () ; 
sp return resultString; 

m ) 

a 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 
+ USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//core ThinAir Server API functionality 
import com. thinairapps .platform. * ; 
import com. thinairapps . platform . device . * ; 
import com. thinairapps . platform . connector . * ,- 
import com. thinairapps .plat form. except ion. * ; 
import com. thinairapps .platform. provider . * ; 

//ThinAir Tag Libraries imports 
import com. thinairapps . tag .* ; 
import com. thinairapps . tag . wml . * ; 

// the groupware packages 

import thinairapps . groupware . api . * ; 

import thinairapps .groupware .api . actions . * ; 

import thinairapps . groupware . api . bounds . * ; 

import thinairapps . groupware . api . exception . * ; 

//Standard Java imports 
jLmport java.util.*; 

sr 

iff 
• i— ? 

''-4 + This utility class renders output as WML for a variety of devices 
,£*/ 

5 "class CRMWMLRenderer 
~4 /**This method renders a deck containing a welcome card 

i jy * 

* ©return the rendered deck. 
I?* */ 

5sa? static String renderStartScreen ( ) 

m { 

1 3 //create the deck 

: ™ WMLTagDocument deck = new WMLTagDocument ( ) ; 

13 //create a card in the deck and give it the ID »cl' 

S-t. DisplayCard cardl = new DisplayCard ( "cl" ) ; 

//create a centered Paragraph 

Paragraph p = new Paragraph (Paragraph .AL I GN_CENTER, Paragraph . MODE_NOWRAP) ; 
Bold b = new Bold(new Text ("Sample CRM Connector")); 
p.addChild(b) ; 
p.addChild(new Break ()) ; 

//add the Paragraph to the card 
cardl .addParagraph (p) ; 

p = new Pa rag raph { Paragraph .AL I GN_LE FT , Paragraph. MODE_NOWRAP) ; 
//Link 

String loginHref = CRMConnec tor . path + "?" + CRMConnector . ACTION_FIELD + "=" + 
CRMConnector . LOGIN_ACTION + " &amp ; rnd= " + Math . random () ; 

//Go task for the href 

Go loginGo = new Go ( loginHref , true , Go . METHOD_GET) ; 
Anchor loginAnchor ; 
//Anchor for the Go task 

if (CRMConnector .g_DEV ICE instanceof NokiaWAPDevice) 

{ 

p . addChi Id ( new Break ( ) ) ; 
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p. addChild (new BreakO); 

loginAnchor = new Anchor ( log inGo, new Text ( "Login" )) ; 
p . addChild ( loginAnchor) ; 

} 

else 

{ 

loginAnchor = new Anchor { log inGo, new Text ( "Login" )) ; 
p . addChild ( loginAnchor) ; 

} 

//add the second Paragraph to the card 
cardl .addParagraph(p) ; 

/ /add the card to the deck 
deck.addCard (cardl) ; 

String resultString = deck - render () ; 
return resultString; 



* This method renders a deck with a card that lets the user specify which action to take 
* 

* ©return the rendered deck. 
*/ 

static String renderOptionMenu ( ) 

{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//create a card in the deck and give it the ID 'cl' 
DisplayCard cardl = new DisplayCard ( "cl ") ; 

//create a centered Paragraph 

Paragraph p = new Paragraph ( Paragraph . ALIGN_CENTER , Paragraph . MODE_NOWRAP ) ; 

Bold b = new Bold (new Text ( "Sample CRM Connector") ) ; 

p. addChild (b) ; 

p. addChild (new BreakO ) ; 

//add the Paragraph to the card 
cardl . addParagraph (p) ; 

p = new Paragraph ( Paragraph . AL I GN_LE FT , Paragraph . MODE_NOWRAP ) ; 
// links to the two possible actions 

String createHref =CRMConnector . path+ "?" + CRMConnector .ACTION_F I ELD + "=" + * 

CRMConnector . CREATE__ACTI ON + " &amp ; rnd= " + Math . random ( ) ; 
String readHref = CRMConnector . path+ " ?" + CRMConnector .ACT I ON_FI ELD + "=" + ^ 

CRMConnector .VIEW_ACTION + M &rnd=" + Math . random () ,- 

// Go tasks for the two hrefs 

Go createGo = new Go (createHref , true , Go . METHOD_GET) ; 
Go readGo = new Go (readHref , true , Go . ME THOD_GET) ; 

Anchor createAnchor ; 
Anchor readAnchor; 

//Anchors for the two Go tasks 

if (CRMConnector .g_DEVICE instanceof NokiaWAPDevice) 

{ 

p . addChild (new Break ( ) ) ; 

createAnchor = new Anchor (createGo, new Text ("Create a new item")); 
p. addChild (createAnchor) ; 
p . addChild (new Break ( ) ) ; 

readAnchor - new Anchor ( readGo , new Text ( "Select View")); 



# # 
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p. addChild (readAnchor) ; 
p.addChild (new Break ()) ,- 

} 

else 

createAnchor = new Anchor (createGo, new Text { "Create a new item" )); 
p. addChild (createAnchor) ,- 

readAnchor = new Anchor (readGo, new Text ( "Select View") ) ; 
p. addChild (readAnchor) ,- 

} 

//add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//add the card to the deck 
deck. addCard (cardl) ; 

String resultString = deck . render () ; 
return resultString; 



* Renders the fields of a single Customltem 
* 

* ©param item the Customltem whose fields we should render 

* ©return the rendered deck. 
*/ 

static String renderCustomltemFields (Customltem item, ConnectorAccess access, String 
sessionld) throws Exception 

{ 

//Get the cache for this session 
Hashtable cache=null; 

cache = access - getSessionCache ( sessionld) ; 

//Storing the item being viewed in the cache 
String itemViewed; 

itemViewed = cache .get ( "ItemViewed" ). toString () ,- 
//Get the messagelD 

String messagelD = ( (Storeltem) item) .getID ( ) ; 
//create the deck 

WMLTagDocument deck « new WMLTagDocument ( ) ,- 
String url = null; 

//create the first card in the deck and give it the ID 1 cl' 
DisplayCard card = new DisplayCard ( "cl " ) ; 

Paragraph p = new Paragraph (Paragraph .AL I GNJLE FT, Paragraph . MODE_NOWRAP) ; 

Bold b = new Bold (new Text ("Item Fields:")); 

p. addChild (b) ; 

p. addChild (new Break ()) ; 

card. addParagraph (p) ; 

Paragraph p2 = new Paragraph ( Paragraph .AL I GN_LE FT, Paragraph . MODE_NOWRAP) ; 

6 

// Now add the fields and their values: 

//first get the Data object that contains all the info about our custom fields. 
Data customFields = item . getCustomFieldData ( ) ; 

//Get an enumeration of the fields... 
Enumeration fieldEnum = customFields . getFields () ; 

// go through the fields, and add each one to the deck - we'll stop after 15, 
// to avoid any deck overflow problems 
int itemsDisplayed = 0; 
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while (f ieldEnum.hasMoreElements () && itemsDi splayed < 15) 
{ 

String f ieldTextName = null; 
String f ieldTextValue = null; 

Field thisField = (Field) fieldEnum. nextElement () ; 

//We must check the type, because that determines how we retrieve the field 
if (thisField. getType () == Field . BOOLE AN_VAL) 

f ieldTextName = thisField . getName 0 ; 
f ieldTextValue = " : " + thisField .getBoolean () ; 

else if (thisField.getTypeO == Field . DOUBLE_VAL) 

f ieldTextName = thisField . getName () ; 
f ieldTextValue = " : " + thisField .getDouble () ; 

else if (thisField.getTypeO == Field . INT_VAL) 

f ieldTextName = thisField. getName 0 ; 
f ieldTextValue = ": " + thisField .getlnt () ; 

else if (thisField.getTypeO == Field. LONG_VAL ) 

f ieldTextName = thisField. getName {) ; 
f ieldTextValue = " : 11 + thisField. getLong () ; 

else if (thisField.getTypeO == Field . STRING_VAL) 

f ieldTextName = thisField .getName 0 ,- 
f ieldTextValue = " : " + thisField. getString () ; 

else if (thisField.getTypeO == Field . DATE_VAL) 

f ieldTextName = thisField. getName {) ; 
f ieldTextValue = " : " + thisField .getDate () ; 

//Transform the field name to the what we want to display as the field name 
//We do this because we want the actual field names in Domino or Exchange to have 
//no spaces, but we want the display names to have spaces (i.e. * 

CustomerName- -Customer Name) 
String f ieldDisplay=null ; 

if (f ieldTextName .equals ("CustomerName 1 ')) 

fieldDisplay= "Customer Name"; 
else if (f ieldTextName . equals ("Position")) 

f ieldDisplay= "Position" ; 
else if (f ieldTextName . equals ( " CompanyName " ) ) 

f ieldD is pi ay=" Company Name"; 
else if (f ieldTextName . equals ("Industry")) 

f ieldDisplay= "Industry" ; 
else if (f ieldTextName . equals ( " ItemCreated" ) ) 

f ieldDisplay=" Item Created"; 
else if (f ieldTextName . equals ("Salescontact")) 

f ieldDisplay= "Sales Contact "; 
else if (f ieldTextName . equals ( "Ac count Number " ) ) 

fieldDisplay=" Account Number"; 
else if (f ieldTextName . equals ( "CustomerStatus " ) ) 
f ieldDisplay= "Customer Status" ; 

//If there' a a field on the form that we're not expecting, 
//don't display it 
else 

{ 

continue ; 



p2 .addChild(new Text ( f ieldDisplay ) ) ; 
p2 .addChild(new Text ( f ieldTextValue) ) ; 
p2 . addChild(new Break ( ) ) ; 
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itemsDisplayed++ ; 

} 

// link home. 

String href = CRMConnector . pat h+ H ?md="+Math . random( ) ; 
//Edit link 

//One parameter must be dedicated to insuring that we have the same item to edit 
String editHref = CRMConnector . pat h+ "? 11 + CRMConnector .ACT I ON_F I ELD + " = " + *t 

CRMConnector .EDI T_ACT I ON + "&amp ,* editPrm= " + itemViewed + " &amp ; rnd= " +Math . random ^ 

() ; 

Go go = new Go (href , true , Go . METHOD_GET ) ; 

Go editGo = new Go(editHref, true, Go . METH0DJ3ET) ; 

Anchor anchor; 
Anchor edit Anchor; 

if (CRMConnector .g_DEV ICE instanceof NokiaWAPDevice) 
{ 

p2 .addChild(new Break () ) ,- 

anchor = new Anchor (go, new TextC'Start again...")); 
p2 . addChild (anchor) ,- 

editAnchor = new Anchor (editGo, new Text ("Edit Item")); 
p2 .addChild (editAnchor) ; 

0 else 

W anchor = new Anchor (go, new TextC'Start again...")); 

Si p2 . addChild (anchor) ; 

£ editAnchor = new Anchor (editGo, new TextC'Edit Item")); 

^ p2 .addChild (editAnchor) ,- 

LI } 

jy card . addParagraph (p2) ; 

deck.addCard (card) ; 
„ return deck . render ( ) ; 



/** This method renders a simple message, either an error or a success, 

* then links back to the main page 

* ©param message the message to be presented to the user 

* ©return the rendered WML deck 
*/ 

static String renderMessage (String message) 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( ) ; 
Paragraph p = new Paragraph ( ) ; 

p. addChild (new Text (message) ) ; 
p. addChild (new Break ( ) ) ; 

//Link home 

String href = CRMConnector . path+ " ?rnd= " + Math . random () ; 
Go go = new Go (href , true , Go .METHOD_GET) ; 
Anchor anchor; 

if (CRMConnector .g_DEVICE instanceof NokiaWAPDevice) 
{ 

p . addChild (new BreakO); 

anchor = new Anchor (go, new TextC'Start again. ..")); 
p . addChild (anchor) ; 

} 

else 
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{ 

anchor = new Anchor (go, new TextC'Start again...")); 
p.addChild(anchor) ; 

} 

card.addParagraph (p) ; 
deck. addCard (card) ; 

String resultString = deck . render () ; 
return resultString; 



/ * * 

* This method renders a deck with several cards including a welcome card and card for 

entering information 

* 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server 

Development Guide . 

* 

* ©return the rendered deck. 

3 */ 

fi static String render Input Form ( ) 

« { 

^ //Create the deck 

-4 WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create a MultiplelnputCard 
^ MultiplelnputCard cardl = new MultiplelnputCard ( "gl " ) ; 

'HI 

|i //Allow the user to type in information and set the input text to lowercase by ^ 

default 

Labeledlnput custName = new Labeledlnput ( "cstnm" , "Customer Name:") ; 
=^ custName . set Format ( 11 *m n ) ; 

^ Labeledlnput position = new Labeledlnput ( "psn" , "Position: ") ; 

!r position . setFormat ( " *m" ) ; 

l ; 

3 Labeledlnput compName = new Labeledlnput ( "cnm" , "Company Name:") ; 

^ compName . setFormat ( " *m" ) ; 

Labeledlnput [] inputsl = {custName, position, compName} ; 

//A link to the second card 

cardl. buildCard("#g2", "OK" , inputsl , Go . METHOD_GET ) ; 
deck. addCard (cardl) ; 

//Create a select card 

SelectlnputCard card2 = new SelectlnputCard ( "g2 ") ; 

Option advertising = new Option ( "OK" , "a" , "Advertising" ) ; 
Option consulting = new Option ( "OK" , "b" , "Consulting" ) ; 
Option entertainment = new Option ( "OK" , "c" , "Entertainment ") ; 
Option finance = new Option ( "OK" , "d" Finance ") ; 
Option government = new Option ("OK", "e", "Government") ; 
Option healthcare = new Option ( "OK" , "f "Health Care") ; 
Option manufacturing = new Option ( "OK" , "g" , "Manufacturing" ) ; 
Option retail = new Option ( "OK" , "h" , "Retail ") ; 

//Make an array of all the options 

Option [] optionsl = {advertising, consulting, entertainment, finance, government, 
healthcare, manufacturing, retail}; 

//Build the card. 

card2 .buildCard( "#g3 " , "Industry: " , " industry" , optionsl , Paragraph .AL I GN_LE FT, Paragraph . * 



# 
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MODE_NOWRAP) ; 

//Add the SelectlnputCard 
deck. addCard (card2) ; 

//Create another Select card 

SelectlnputCard cards = new SelectlnputCard < M g3"); 
Option bulgakov = new Option ( "OK" , "a" , "Mikhail Bulgakov"); 
Option diamond = new Option ( "OK" , "b" , "Neil Diamond") ,- 
Option donaldson = new Option { "OK" , "c ", "Sam Donaldson"); 
Option feynman = new Opt ion ( "OK" , "d" , "Richard Feynman"),* 
Option frazier = new Option ( "OK" , "e" , "Joe Frazier") ; 
Option rimbaud = new Option ( "OK" , " f ", "Arthur Rimbaud"); 
Option trotsky = new Option ( "OK" , "g" , "Leon Trotsky"); 
Option yeoh = new Option ( "OK" , "h" , "Michelle Yeoh"); 

Option [] optionsS = {bulgakov, diamond, donaldson, feynman, frazier, rimbaud, trotsky 



//Build the card 

cards .buildCard ( "#g4" , "Sales Contact : " , "salescontact" , optionsS , Paragraph .ALIGN_LEFT, * 
Paragraph.MODE_NOWRAP) ; 

//Add the SelectlnputCard 
deck -addCard{ cards) ; 

//Create a MultiplelnputCard 

MultiplelnputCard card3 = new MultiplelnputCard ( l! g4 ") ; 

Labeledlnput actNumber = new Labeledlnput ( "an" , "Account Number:"); 
actNumber . set Format ( " *m" ) ; 

Labeledlnput [] inputs2 = {actNumber}; 

card3 .buildCard ( " #g5 " , "OK" , input s2 , Go . METHOD_GET ) ; 
deck. addCard (card3 ) ; 

//Create a select card 

SelectlnputCard card4 = new SelectlnputCard { M g5 ") ; 

Option needsf irstcontact = new Option ( "OK" , "a" , "Needs First Contact"); 

Option needsf ollowup = new Option ( "OK" , "b" , "Needs Follow-Up") ; 

Option needscreditapproval =■ new Option ( "OK" , "c" , "Needs Credit Approval"); 

Option needstobeinvoiced new Option ( "OK" , "d" , "Needs to be Invoiced") 

Option creditapproved ~ new Option ( "OK" , "e" 7 "Credit Approved"); 

Option invoicesent = new Option ( "OK" , " f " # " Invoice Sent"); 

Option creditdenied = new Option ( "OK" , "g" , "Credit Denied") ; 

Option deadend = new Option ( "OK" , "h" , "Dead End"); 

//Make an array of all the options 

Option [] options2 {needsf irstcontact , needsf ollowup, needscreditapproval, * 
needstobeinvoiced, creditapproved, invoicesent, creditdenied, deadend}; 

//Set the URL params to the values in the WML variables 

//&, the escape sequence for ampersand, delimits name-value pairs. $ is used to * 

dereference a WML variable . 
String href; 

href = CRMConnector .path + "?action=display&cstnm=$cstnm&psn=$psn6camp;cnm=$ \l 
c nm&amp ; i ndu s t ry = $ i ndu s t ry&amp ; spm= $ spm&amp ,-sc = $sales Con tact &amp ; an= $ an &amp ; 
custstatus=$cust status&amp ; rnd= "+Math . random ( ) ; 



//Build the card. 

card4 .buildCard (href , "Customer Status : " , "custstatus " , options2 , Paragraph . ALIGN_LEFT, ^ 
Paragraph . MODE_NOWRAP) ; 



, yeoh}; 



//Add the SelectlnputCard 
deck . addCard (card4 ) ; 



C: \TASS\WireIessSDK\ . . \Connectors\CRM\src\CRMWMLRenderer'. java 



//Render the deck 
return deck . render () ; 

} 



I * * 

* Display to the user the available ways that they can view the data in the folder. 

* renderOptionMenu ( ) renders an option screen, users select one of those options and 

* Handle () checks the URL and then calls this method if users wanted to see all the 
views 

* available to them 
* 

* ©return the rendered WML deck 
*/ 

static String re nderAva liable Views () 

{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//create a card in the deck and give it the ID 'cl 1 
DisplayCard cardl = new DisplayCard ( "cl ") ; 

//create a centered Paragraph 

Paragraph p = new Paragraph (Paragraph. Ail GN_CENTER, Paragraph. MODE JNOWRAP) ,* 
Bold b = new Bold(new Text ( "Select a View")); 
p.addChild(b) ; 
p.addChild(new Break ()) ; 

\M 

v y //add the Paragraph to the card 

s g cardl .addParagraph(p) ; 

p = new Paragraph ( Paragraph. ALIGN_LEFT, Paragraph. MODE JSTOWRAP) ; 

|p // links to the possible actions 

String byStatusHref =CRMConnector . path+ "?" + CRMConnector . ACTION_FIELD + 11 = " + * 
^ CRMConnector . VIEW_BY_STATUS + " &amp ; rnd= " + Math . random () ; 

Ms String bylndustryHref = CRMConnector . pa th+ " ?" + CRMConnector .ACT I ON_F I ELD + + 
\fx CRMConnector .VI EW_BY_INDUSTRY + " &amp ; rnd= w + Math . random () ; 

]U String bySalesContactHref = CRMConnector . pat h+ "?" + CRMConnector .ACT I ON_FI ELD 
jjj + " = " + CRMConnector . VIEW_BY_SALESCONTACT + " &amp ; rnd= " + Math . random () ; 

!□ // Go tasks for the hrefs 

Go byStatusGo = new Go (byStatusHref , true , Go . METHOD_GET) ; 
5 ™ Go bylndustryGo = new Go (bylndustryHref , true , Go .ME THOD_GET) ; 

Go bySalesContactGo = new Go (bySalesContactHref , true , Go . METHOD__GET ) ; 

Anchor byStatusAnchor; 
Anchor bylndus try Anchor; 
Anchor bySalesContactAnchor ,- 

// Anchors for the two Go tasks 

if (CRMConnector .g_DE VICE instanceof NokiaWAPDevice) 

{ 

p . addChild (new Break () ) ; 

byStatusAnchor = new Anchor (byStatusGo, new Text ( "View by Status") ) ; 
p . addChild (byStatusAnchor) ; 

p . addChild (new Break ( ) ) ; 

bylndustryAnchor = new Anchor (bylndustryGo, new Text ( "View by Industry Name")); 
p. addChild (by Indus tryAnchor) ; 

p. addChild (new Break () ) ; 

bySalesContactAnchor = new Anchor (bySalesContactGo , new Text ("View by Sales 

Contact") ) ; 
p . addChild (bySalesContactAnchor) ; 



p. addChild (new Break () ) ; 
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else 

byStatusAnchor = new Anchor (byStatusGo, new Text ( "View by Status")); 
p.addChild(byStatusAnchor) ; 

bylndustryAnchor = new Anchor (by Indus tryGo, new Text ("View by Industry Name")); 
p. addChi Id (by Indus try Anchor) ; 

bySalesContactAnchor = new Anchor (bySalesContactGo , new Text ("View by Sales * 

Contact") ) ; 
p . addChi Id (bySalesContactAnchor) ; 

} 

//add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//add the card to the deck 
deck. addCard (cardl) ; 

String resultString = deck . render () ; 
return resultString ; 



/** 

,5 * This method renders the fields in a selected view. 

* TO DO -- display the number of items that have each field 
'sj * TO DO turn this connector into a collection of widgets that 
g * are more generic 

W * ©param customltems All of the items in the folder 

"H * ©param view The view that the user wants to use on these items 

i*Q * ©return A rendered WML deck 

r */ 

*~. static String renderView (Storeltems customltems, String view) 

\d { 

m //create the deck 

^ WMLTagDocument deck = new WMLTagDocument ( ) ; 

Uj //create a card in the deck and give it the ID f cl' 

|3 DisplayCard cardl = new DisplayCard ( "cl " ) ; 

//create a centered Paragraph 

Paragraph p = new Paragraph ( Paragraph . ALIGN_CENTER , Paragraph . MODE_NOWRAP) ; 

if (view. equals (CRMConnector . VIEW_BY_STATUS) ) 

Bold b = new Bold (new Text ( "View By Customer Status:")); 

p.addChild(b) ; 

p .addChild (new Break () ) ; 

//add the Paragraph to the card 
cardl .addParagraph (p) ; 

p = new Paragraph ( Paragraph . ALIGN_JLEFT , Paragraph . MODE_NOWRAP ) ; 
//Add links to all the possible actions 

String [] statusHREFNames * 
= { "nfcHref" , "nfHref " , "ncaHref " , "ntbiHref " , "caHref " , "isHref " , "cdHref " , "deHref * 

*'}; 

String [] statusURLParams = {CRMConnector . STSJSTEEDS_F I RST_CONTACT, CRMConnector . * 
STS_NEEDS_FOLLOWUP , CRMConnector . STS_NEEDS_CREDIT_APPROVAL , CRMConnector . ^ 
STS_NEEDSJTO_BE_ INVOICED, CRMConnector . STS_CREDIT_APPROVED, CRMConnector . ^ 
STS_INVOICE_SENT, CRMConnector . STS_CRED I T_DENI ED, CRMConnector . STS_DEAD_END} ; 

Go[] statusGoNames = {new Go (statusHREFNames [0] , true, Go. METHOD_GET) , new Go ^ 
(statusHREFNames [1] , true , Go . METHOD_GET) , new Go ( statusHREFNames [2] , true, Go. 
METHOD_GET ) , new Go ( statusHREFNames [3 ], true , Go . METHOD_GET) , new Go * 



# 
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(statusHREFNames [4] , t rue , Go . METHOD_GET) , new Go ( statusHREFNames [5] , true, Go. / 
METHOD_GET) , new Go ( statusHREFNames [6 ], true , Go .METHOD_GET) , new Go / 
(statusHREFNames [7} , t rue , Go . METHOD_GET ) } ; 

String [] statusAnchorDisplayText = {"Needs First Contact " , "Needs / 
Follow-Up" , "Needs Credit Approval" , "Needs to be Invoiced", "Credit / 
Approved" , "Invoice Sent ", "Credit Denied" , "Dead End"}; 

com. thinairapps. tag. wml. Anchor [] statusAnchorNames = {new com. thinairapps . tag . wml / 
.Anchor ( statusGoNames [0] , new Text (statusAnchorDisplayText [0] )), new com. / 
thinairapps. tag. wml .Anchor (statusGoNames [1] , new Text ( statusAnchorDisplayText / 
[1] )) ,new com. thinairapps. tag. wml. Anchor (statusGoNames [2] , new Text / 
(statusAnchorDisplayText [2J ) ) , new com. thinairapps . tag . wml .Anchor / 
(statusGoNames [3] , new Text ( statusAnchorDisplayText [3] )), new com. thinairapps . / 
tag. wml .Anchor (statusGoNames [4] , new Text ( statusAnchorDisplayText [4] ) } ,new com* 
. thinairapps . tag .wml .Anchor ( statusGoNames [5] ,new Text (statusAnchorDisplayText/ 
[5])), new com. thinairapps . tag .wml .Anchor (statusGoNames [6] , new Text / 
(statusAnchorDisplayText [6] )) , new com . thinairapps . tag . wml .Anchor / 
(statusGoNames [7] ,new Text (statusAnchorDisplayText [7] ) ) } 

int i ; 

for (i = 0; i < 8; i++) 



{ 



statusHREFNames [i] = CRMConnector .path* "?" + CRMConnector . ACTION_FIELD 

+ " = " + statusURLParams [i] + "&rnd=" + Math . random () ; 
statusGoNames [i] = new Go (statusHREFNames [i] , true, Go. METHOD__GET) ; 
if (CRMConnector .g_DE VICE instanceof NokiaWAPDevice) 
{ 

. p.addChild(new Break ( ) ) ; 
statusAnchorNames [i] = new Anchor ( statusGoNames [i] , new Text 

(statusAnchorDisplayText [i] ) ) ; 
p. addChild (statusAnchorNames [i] ) ; 
p.addChild (new Break ( ) ) ; 

} 

else 

{ 



statusAnchorNames [i] = new Anchor ( statusGoNames [i] , new Text / 
firt (statusAnchorDisplayText [i] ) ) ; 

p.addChild (statusAnchorNames [i] ) ; 

h } } 

13 //add the second Paragraph to the card 

] ~ cardl . addParagraph ( p ) ; 

"=3 //add the card to the deck 

1^ deck. addCard( cardl) ; 

else if (view. equals (CRMConnector .VIE W_BY_INDUSTRY) ) 

Bold b = new Bold (new Text ( "View By Industry Name:")); 

p. addChild (b) ; 

p . addChild (new Break ( ) ) ; 

//add the Paragraph to the card 
cardl . addParagraph (p) ; 

p = new Paragraph ( Paragraph . AL I GN_LE FT , Paragraph . MOD E__NO WRAP ) ; 
//Add links to all the possible actions 

String [] industryHREFNames * 
= { "advHref " , "conHref" , "entHref" , "f inHref " , "govHref " , "heaHref " , "manHref " , "ret/ 
Href" } ; 

String [3 industryURLParams = { CRMConnector . I_ADVERTISING, CRMConnector . / 
I ^CONSULTING, CRMConnector . I_ENTERTAINMENT, CRMConnector . I _F I NANCE , CRMConnector/ 
. I_GOVERNMENT , CRMConnector . I _HE ALTHCARE , CRMConnector . I _MANU FACTORING , / 
CRMConnector . I_RETAIL} ; 

Go[] industryGoNames = {new Go ( industryHREFNames [0] , true , Go .METHODJ3ET) , new Go / 
(industryHREFNames [1] , true , Go . METHOD_GET) , new Go ( industryHREFNames [2] , true, Go/ 
. METHOD_GET ) , new Go ( industryHREFNames [3 ], true , Go . METHOD_GET) , new Go / 
(industryHREFNames [4] , true , Go . METHOD_GET) , new Go ( industryHREFNames [5 ] ,true,Go/ 
. METHOD_GET ) , new Go ( industryHREFNames [6] , true , Go .METHOD_GET) , new Go / 
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(industryHREFNames [7] , true , Go . METHOD_GET) }; 

String [3 industryAnchorDisplayText 

= { "Advertising" , "Consulting" , "Entertainment" , "Finance" , "Government" , "Healthctf 
are" , "Manufacturing" , "Retail" } ; 

com. thinairapps . tag .wml .Anchor [] industryAnchorNames = {new com. thinairapps . tag . 

wml .Anchor (industryGoNames [0] , new Text (industryAnchorDisplayText [0] ) ) ,new com/ 
. thinairapps . tag. wml .Anchor (industryGoNames [13 , new Text / 
(industryAnchorDisplayText [13 ) ) , new com. thinairapps . tag .wml .Anchor 
(industryGoNames [2 3 , new Text (industryAnchorDisplayText [2] ) ) , new com. 
thinairapps . tag. wml .Anchor (industryGoNames [33 , new Text / 
(industryAnchorDisplayText [3] ) ) , new com. thinairapps . tag . wml .Anchor 
(industryGoNames [43 , new Text (industryAnchorDisplayText [4] ) ) , new com. 
thinairapps . tag .wml .Anchor (industryGoNames [5 ] , new Text / 
(industryAnchorDisplayText [53 ) ) , new com. thinairapps . tag .wml .Anchor uf 
(industryGoNames [6] , new Text (industryAnchorDisplayText [63 ) ) , new com. \l 
t hinairapps. tag. wml. Anchor (industryGoNames [7] , new Text 
(industryAnchorDisplayText [73 ) ) } ; 

int i ; ' 

for (i = 0; i < 8; i++) 

^ industryHREFNames [i] = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELD 
+ "=" + industryURLParams [i3 + " &amp ; rnd= " + Math . random () ; 
industryGoNames [i] = new Go (industryHREFNames [i3 , true^, Go. METHOD_GET) / 
if (CRMConnector .g_DEVICE instanceof NokiaWAPDevice) 
{ 

13 p . addChild (new Break ( ) ) ; 

[f± industryAnchorNames [i] = new Anchor ( industryGoNames [i] , new Text 

;Jf (industryAnchorDisplayText [i] ) ) ; 

S p. addChild (industryAnchorNames [i] ) ; 

d p .addChild (new Break ( ) ) ; 

£ } 

else 

'--J industryAnchorNames [i] = new Anchor ( industryGoNames [i3 , new Text 

j¥% (industryAnchorDisplayText [i] ) ) ; 

:|% " p. addChild ( indust ryAncho rNames [i3 ) ; 

_ } 

\i } 

iii 

|«. //add the second Paragraph to the card 

;J cardl . addParagraph (p) ; 

□ //add the card to the deck 

1^ deck. addCard (cardl) ; 

else if (view. equals (CRMConnector . VI EW_BY_S ALES CONTACT) ) 

^ Bold b = new Bold (new Text ("View By Sales Contact:")); 
p. addChild (b) ; 
p. addChild (new Break () ) ; 

//add the Paragraph to the card 
cardl . addParagraph (p) ; 

p = new Paragraph ( Paragraph. ALIGN_LEFT, Paragraph. MODE_NOWRAP) ; 
//Add links to all the possible actions 

String [3 salescontactHREFNames * 
= { "arHref " , " jfHref " , " 1 tHref " , "myHref " , "mbHref " , "ndHref " , "rfHref " , "sdHref " } ; 

String [3 salescontactURLParams = {CRMConnector . SC_ARTHUR_RIMBAUD, CRMConnector . * 
SC_JOE_FRAZIER / CRMConnector . SC_LEON_TROTSKY , CRMConnector . SC_MICHELLE_YEOH, 
CRMConnector . SC_MIKHAIL_BULGAKOV, CRMConnector . SC_NE I L_D I AMOND, CRMConnector . * 
SC_RICHARD_FEYNMAN, CRMConnector . SC_SAM_DONALDSON} ; 

Go[] salescontactGoNames = {new Go ( salescontactHREFNames [0] , true , Go . METHOD_GET) , 

new Go (salescontactHREFNames [1] , true , Go . METHOD_GET) , new Go * 
(salescontactHREFNames [2] , true , Go . METHOD_GET) , new Go (salescontactHREFNames 
[33 , true , Go . METHOD__GET ) , new Go ( salescontactHREFNames [4] , true , Go .METHOD_GET) , 
new Go (salescontactHREFNames [53 , true, Go .METHOD_GET) , new Go * 
(salescontactHREFNames [6] , true , Go . METHOD_GET) , new Go (salescontactHREFNames 
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[ 7 ] , t rue , GO . METHODJ3ET ) } ; 

String [3 salescontactAnchorDisplayText = {"Arthur Rimbaud" , "Joe Frazier " , "Leon 

Trotsky" , "Michelle Yeoh 11 , "Mikhail Bulgakov" , "Neil Diamond" , "Richard * 
Feynman" , "Sam Donaldson" } ; 

com. thinairapps . tag .wml .Anchor (] salescontactAnchorNames ={new com. thinairapps . * 
tag .wml .Anchor ( salescontactGoNames [0] ,new Text (salescontactAnchorDisplayText 
[0] ) ) ,new com. thinairapps . tag .wml .Anchor (salescontactGoNames [1] , new Text \£ 
(salescontactAnchorDisplayText [1] ) ) , new com. thinairapps . tag .wml .Anchor * 
(salescontactGoNames [2] ,new Text (salescontactAnchorDisplayText [2 ] ) ) ,new com. * 
thinairapps . tag .wml .Anchor (salescontactGoNames [3] , new Text *r 
(salescontactAnchorDisplayText [3] ) ) , new com. thinairapps . tag .wml .Anchor 
(salescontactGoNames [4] ,new Text ( salescontactAnchorDisplayText [4 ] ) ) ,new com. 
thinairapps . tag .wml .Anchor (salescontactGoNames [5] , new Text 

(salescontactAnchorDisplayText [5] ) ) ,new com. thinairapps . tag .wml .Anchor * 
(salescontactGoNames [6] , new Text ( salescontactAnchorDisplayText [6 ])), new com. 
thinairapps . tag .wml .Anchor (salescontactGoNames [7] , new Text wT 
(salescontactAnchorDisplayText [7] ) ) } ; 
int i ; 

for (i = 0; i < 8; i + +) 
{ 

salescontactHREFNames [i] = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELDW 

+ " = " + salescontactURLParams [i] + " &amp ; rnd= " + Math . random () ; 
salescontactGoNames [i] = new Go (salescontactHREFNamesJi] , true , Go . METHOD_GET) ; 
if (CRMConnector .g__DEVICE instanceof NokiaWAPDevice) 
{ 

□ p . addChild (new BreakO); 

salescontactAnchorNames [i] = new Anchor ( salescontactGoNames [ i] , new Text *f 
?? (salescontactAnchorDisplayText [i] ) ) ; 

U p . addChild (salescontactAnchorNames [i] ) ; 

y p . addChild (new BreakO); 

c } 

else 

M { 

H salescontactAnchorNames [i] = new Anchor ( salescontactGoNames [i] , new Text 

|1 (salescontactAnchorDisplayText [i] ) ) ; 

p. addChild (salescontactAnchorNames [i] ) 

} 

s . } 

Wz 

=sj //add the second Paragraph to the card 

If cardl . addParagraph (p) ; 

2 / /add the card to the deck 

^ deck. addCard (cardl) ; 

} 

String resultString = deck . render () ; 
return resultString; 



/ * * 

*A user selects a field value by which to sort the contents of the folder and 

* then this method is called to display all the items that have that value 
★ 

* ©param fieldValue The value of the field by which the user wants to sort the folder 

* @param access A handle to ConnectorAccess and the ThinAir Server services 

* ©param sessionld An identifier of the user's already established session 

* ©return A collection of Storeltems that satisfy the criteria of the user 

*/ 

static String viewByField (String fieldValue, ConnectorAccess access, String sessionld) 
throws Exception 

{ 

//Create the deck, and add a few elements to it 
WMLTagDocument deck = new WMLTagDocument ( ) ; 
String url = null; 

DisplayCard card = new DisplayCard ( "cl" ) ; 

Paragraph p = new Paragraph (Paragraph .ALIGN_LEFT, Paragraph. MODE_NOWRAP) ; 
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Bold b = new Bold(new Text ( "Matching Items:")); 
p.addChild(b) ; j 
p.addChild(new Break ( ) ) ; 
card.addParagraph (p) ; 

Paragraph p2 = new Paragraph (Paragraph . ALIGN_LEFT, Paragraph . MODE_NOWRAP ) ; 

//The cache for this session 
Hashtable cache = null; 

//The Vector that will store the items that have fields that match the incoming 
//field parameter 

Vector itemswMatchingf ields = new Vector (15) ; 

//Get the cache for this session 

cache = access . getSessionCache (sessionld) ; 

//Retrieve the Store Items that we've already placed into the cache 
Storeltems customltems = ( (Storeltems) cache .get ( "storeltems" )) ; 

//we get an Enumeration of the items... 

Enumeration sortedltemEnum = (( (Vector) customltems) . elements ()) ; 
boolean didAnyltemsMatch = false; 

//Go through the items, and identify those that have the field that 

//has been passed in as the search parameter. 
3 int itemlterated = 0; 

n String elementNumber = "eletnnum" ,- 

S String href = " " ; 

Go go = new Go (href, true, Go - METHOD_GET ) ; 
H Anchor itemAnchor; 

IP while (sortedltemEnum. hasMoreElements () ) 

a . ( 

^ String fieldText = null ; 

Si String companyName = null; 

B Customltem custltem = (CustomI tern) sortedltemEnum. nextElement () ; 

_ //Get the fields of the item 

*f Data customFields = custltem. getCustomFieldData () ; 

==\ //Get an enumeration of the fields 

S Enumeration fieldEnum = customFields . getFields () ; 

3 //If the search parameter matches a field on the item, then we return a link to 

//item with the item's company name displayed. 

boolean hasField = false; 

while (fieldEnum. hasMoreElements ( ) ) 

Field thisField = (Field) fieldEnum. nextElement () ; 

//Get the Item's Company Name field. We need it for displaying a link to thetf 
item. 

if (thisField. getName () .equals ("CompanyName")) 
{ 

companyName = thisField . getString () ; 
if (hasField -= true) 

//Create the link to the Item, with the Company Name field rendered 
href = CRMConnector .path+ "?" + CRMConnector . ACTION_FIELD + = " + ^ 
CRMConnector . VIEW_BY_FIELD_ACTION + " &amp ; e 1 emnum= " + * 
itemlterated + "&rnd= M + Math . random ( ) ; 

go = new Go(href, true, Go . METHOD_GET) ; 

if (CRMConnector .g_DEVICE instanceof NokiaWAPDevice) 

itemAnchor = new Anchor (go, new Text (companyName)); 
p2 .addChild (new Break ()) ; 
p2 . addChi Id ( itemAnchor) ; 

} 
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else 

itemAnchor = new Anchor (go, new Text ( companyName ) ) ; 
p2 .addChild (itemAnchor) ; 

} 

p2 .addChild(new Break () ) ; 
didAnyltemsMatch = true; 

companyName = null ; 
hasField = falser- 
break; 

} 

else 

continue; 

} 

//We will display links only to those items that match the search criteria 

else if (thisField.getStringO .equals (fieldValue) ) 

{ 

hasField = true; 

if (! (companyName == null)) 

//Create the link to the Item, with the Company Name field rendered 
href = CRMConnector ,path+ "?" + CRMConnector . ACTION_FIELD + "=" + ^ 
O CRMConnector .VIE W_BY_F I ELD_ACTI ON + " & elemnum= " + ^ 

■.Q itemlterated + "&rnd=" + Math . random () ; 

!^ go = new Go (href, true, Go . METHOD_GET ) ; 

.E: if (CRMConnector .g_DEV ICE instanceof NokiaWAPDevice) 

7d { 

itemAnchor = new Anchor (go, new Text (companyName) ) ; 
"""j p2 . addChild (new Break ( ) ) ,- 

I D p2 . addChi 1 d ( i t emAnchor ) ; 

} * 
j» else 

l i i 

ijl itemAnchor = new Anchor (go, new Text (companyName) ) ; 

r- s p2 . addChild (itemAnchor) ; 

% • ) 

O p2 .addChild (new Break ()) ; 

l^. didAnyltemsMatch = true; 

companyName = null; 
hasField = false; 
break ; 

} 

else 

continue ; 

} 

} // end while 
itemlterated++ ; 

} 

//If no items matched the criteria, render this fact 
if (didAnyltemsMatch == false) 

{ 

p2 . addChild (new Break ()) ; 

p2 .addChild (new Text ( M No Items to Display 1 ')); 

p2 . addChild (new Break ()) ; 

p2 . addChild (new Break ()) ; 

} 

//Else add one more break 

else if ( ! (didAnyltemsMatch == false) ) 

{ 

p2 . addChild (new Break ( ) ) ; 

} 
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//link home. 

String startHref = CRMConnector .path+ " ?rnd= " +Math . random ( ) ; 

Go startGo = new Go (startHref , true, Go. METHOD_GET) ,- 
Anchor startaAnchor; 

if (CRMConnector .g_DEVICE instanceof NokiaWAPDevice) 

{ 

p2 . addChild (new Break ()) ; 

startaAnchor = new Anchor ( startGo, new TextC'Start again...")); 
p2 .addChild (startaAnchor) ; 

} 

else 

{ 

startaAnchor = new Anchor ( startGo, new TextC'Start again...")); 
p2. addChild ( startaAnchor ) ,- 

} 

card.addParagraph(p2) ; 
deck.addCard (card) ; 
return deck . render () ; 



I * * 

3 * Renders an input form with the values preset 
'—. * 

Jf * Pass in the field values that the item had. 

M * ©param item -- 

J * ©param messagelD -- 

™~ * 

t */ 

fes static String edit I tern (CustomI tern item, String messagelD) 

4 { 

■f\ //Get the Data object that contains all our custom fields. 
^ Data customFields = item.getCustomFieldData ( ) ; 

□ //Get the fields that we're expecting 

11 String customerNameField = customFields . get Field ( "CustomerName" ). valueToSt ring () ; 

L" String positionField = customFields . getField ( " Position" ) . valueToString () ; 

r £ String companyNameField = customFields .getField ( "CompanyName" ) .valueToString () ; 

fi String industryField = customFields . getField ( " Industry" ) .valueToString () ; 

□ String itemCreatedField = customFields .getField (" ItemCreated" ). valueToString () ; 

7 String salesContactField = customFields . getField ( "Salescontact ") .valueToString () ,- 

^ String accountNumberField = customFields .getField ( "AccountNumber" ) .valueToString () ; 

String customerStatusField = customFields .getField ( "CustomerStatus" ) .valueToString () ; 

//Create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
//Create a MultiplelnputCard 

MultiplelnputCard cardl = new MultiplelnputCard ( "gl ") ; 

//Allow the user to type in information and set the input text to lowercase by default 
Labeledlnput custName = new Labeledlnput ( "cstnm" , "Customer Name : " ) ; 
custName . setFormat ( " *m" ) ; 
//Set the default value 

custName . addAttribute ("value", customerNameField) ; 

Labeledlnput position = new Labeledlnput ("psn" , "Position: ") ; 
position . setFormat ( " *m" ) ; 
//Set the default value 

position. addAttribute ("value" , positionField); 

Labeledlnput compName = new Labeledlnput ( "cnm" , "Company Name : " ) ; 
compName . setFormat ( " *m" ) ; 
//Set the default value 

compName . addAttribute ("value", companyNameField); 
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Labeledlnput [] inputsl = {custName, position, compName}; 
//A link to the second card 

cardl . buildCard ( " #g2 " , "OK" , inputsl , Go . METHOD_GET ) ,- 
deck.addCard(cardl) ; 

//Create a select card 

Card card2 = new Card ( n g2 n , "industry"); 
//Create the Do 

Do doElem = new Do (Do . TYPE_ACCEPT / new Go ( "#g3 " , false) ) ; 

//Add the do 

card2 .addChild(doElem) ; 

//Create a paragraph 

Paragraph p = new Paragraph ( Paragraph .AL I GN_LE FT, Paragraph . MODE_NOWRAP ) ; 
p . addChild (new Text { "Industry : " ) ) ; 

//Add the paragraph 
card2 . addParagraph (p) ; 

//Add another paragraph 

Paragraph p2 = new Paragraph (Paragraph. ALIGN_LE FT, Paragraph . MODE_NOWRAP) ; 
//Create a select 

Select industrySelect = new Select { " " , " industry " , false) ; 

String [3 industryOptionNames * 
= {"Advertising" , "Consulting" , "Entertainment" , "Finance" , "Government" , "Health * 
Care", "Manufacturing" , "Retail"} ,- 

Option [] industryOptions = new Option [8] ; 

String [] industryOptionValues = { "a" , "b" , "c" , "d" , "e" , "f " , "g" , "h" } ; 
String [] industryOptionlValues = { " 1 " , "2 " , "3 " , "4 " , " 5 " , "6 " , " 7 « , » 8 " } ; 

int i ,* 

for (i=0; i<8; i++) 

industryOptions [i] = new Option ( "OK" , industryOptionValues [i] , industryOptionNames 
[i] ) ; 

industrySelect .addOpt ion ( industryOptions [i] ) ; 

if (industryField. equals ( industryOptionValues [i] ) ) 

industrySelect . setlNameAndlValue { industryOptionValues [i] , industryOptionlValues * 
[i] ) ; 

} 

//Add the select to the paragraph 
p2 .addChild (industrySelect ) ; 

//Add the second paragraph 
card2 .addChild (p2) ; 

//Add the card 
deck.addCard(card2) ; 



//Create a select for Sales Contact 
Card cards = new Card ("g3"); 

//Create the Do 

Do salesDo = new Do (Do . TYPE_ACCEPT, new Go ( "#g4 false) ) ; 
//Add the do 

cardB .addChild (salesDo) ; 
//Create a paragraph 

Paragraph sP = new Paragraph (Paragraph .AL I GN_LE FT , Paragraph . MODE_NOWRAP) ,- 
sP. addChild (new TextC'Sales Contact:")); 
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//Add the paragraph 
card5 .addParagraph(sP) ; 

//Add another paragraph 

Paragraph sP2 = new Paragraph ( Paragraph .AL I GN_LE FT, Paragraph . MODE_NOWRAP ) ,- 
//Create a select 

Select salesSelect = new Select ( " " , " salescontact H , false) ; 

String [] salesOptionNames = {"Mikhail Bulgakov", "Neil Diamond" , "Sam Donaldson" , "Richard *£ 

Feynman" , "Joe Frazier" , "Arthur Rimbaud" , "Leon Trotsky" , "Michelle Yeoh" } ; 
Option [] salesOptions = new Option [8] ; 

String [] salesOptionValues = { "a" , "b" , "c" , "d" , "e" , "f " , "g" , "h" } ; 
String [] salesOptionlValues « { " 1 » , " 2 " , "3 " , "4 " , " 5 " , » 6 " , " 7 " , " 8 " } ; 

int k ; 

for (k=0; k<8; k++) 

salesOptions [k] = new Option ( "OK" , salesOptionValues [kj , salesOptionNames [k] ) ,- 
salesSelect .addOpt ion (salesOptions [k] ) ; 
if (salesContactField. equals ( salesOptionValues [k] ) ) 

salesSelect . setlNameAndl Value ( salesOptionValues [k] , salesOptionlValues [k] ) ; 

} 

//Add the select to the paragraph 
sP2 .addChild (salesSelect) ,- 

//Add the second paragraph 
cards. addChild (sP2) ; 

g //Add the card 

% deck. addCard (cards) ; 

-J //Create a MultiplelnputCard 

n MultiplelnputCard card3 = new MultiplelnputCard ( "g4 ") ; 

Labeledlnput actNumber = new Labeledlnput ( "an" , "Account Number:") ; 
3 actNumber . setFormat ( " *m" ) ; 

fl actNumber . addAttribute ( "value" , accountNumber Field) ; 
^ Labeledlnput [] inputs2 = {actNumber}; 

□ card3 .buildCard ( "#g5" , "OK" , inputs2 , Go . METHOD_GET ) ; 
"T deck . addCard (card3 ) ; 



//Create a select card 

Card card6 = new Card ("g5", "Customer Status"); 
//Create a paragraph 

Paragraph p3 = new Paragraph (Paragraph .ALIGN_LEFT, Paragraph . MODE_NOWRAP ) ; 
p3 .addChild (new Text ( "Customer Status") ) ; 

//Add the paragraph 
card6 . addPara^raph ( p3 ) ; 

//Add another paragraph 

Paragraph p4 = new Paragraph ( Paragraph .AL I GN_LEFT, Paragraph . MODE_NOWRAP) ; 
//Create a select 

Select custstatusSelect = new Select ("", "cust status *' , false) ; 

String [] custstatusOpt ionNames = {"Needs First Contact ", "Needs Follow-Up" , "Needs Credit * 
Approval" , "Needs to be Invoiced" , "Credit Approved" , " Invoice Sent ", "Credit . * 
Denied" , "Dead End" } ; 

Option[] custstatusOptions = new Option [8] ; 

String [] custstatusOptionValues = { "a" , "b" , "c" , "d" , "e" , " f " , "g" , "h" } ; 
String [] custstatusOpt ionlValues = { « 1 " , " 2 " , " 3 " , "4 " , " 5 " , " 6 " , " 7 " , " 8 " } ; 
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int j ; 

for (j=0; j<8; 

{ 

custstatusOptions [ j ] = new Option ( "OK" , custstatusOptionValues [ j ] , * 

custstatusOptionNames [ j] ) ,- 
custstatusSelect .addOption (custstatusOptions C j ] ) ; 
if (customerStatusField. equals (custstatusOptionValues [j ]) ) 

custstatusSelect . set INameAndl Value (cust statusOptionValues [ j ] , 
custstatusOptionlValues t j ] ) ; 

} 

//Set the URL params to the values in the WML variables 

//&, the escape sequence for ampersand, delimits name-value pairs. $ is used to 

dereference a WML variable. 
String href; 

href = CRMConnector .path + "Paction^" + CRMConnector . UPDATE_ACT I ON + " & "+ "MessagelD 
="+messageID+ "&cstnm=$cstnm&psn=$psn&cnm=$cnm& industry=$industry& 
spm=$ spm&amp ; sc=$salesContact&amp / an=$an&amp ; cust status=$cust status&amp ; rnd= " +Math . 
random () ; 

//Create the Do 

Do custDo = new Do (Do . TYPE_ACCEPT, new Go (href , false) ) ; 

//Add the do 
_ cards . addChild (custDo) ; 

h Q //Add the select to the paragraph 
p4 .addChild (custstatusSelect) ; 

'""4 //Add the second paragraph 
: £ card6.addChild(p4) ; 

;^ //Add the card 

deck.addCard(card6) ; 

\ J3 

//Render the deck 
"™ return deck . render ( ) ; 

ift/end Connector 



